遇到 ReferenceError: $ is not defined 這個錯誤,第一直覺通常就是「沒引用到 jQuery 函式庫」。但奇怪的是,明明已經引入了,瀏覽器卻還是報錯。

折騰了一陣子後,發現問題出在路徑寫法上。把原本的:
<script type="text/javascript" src="/statics/js/jquery-1.4.2.min.js"></script>
改成去掉開頭斜線的相對路徑後,居然就正常了:
<script type="text/javascript" src="statics/js/jquery-1.4.2.min.js"></script>
雖然在 IIS 中有啟用絕對路徑,但用絕對路徑時就是會出問題,實在想不透原因;而把 jquery-1.4.2.min.js 直接放在同目錄下反而可以正常運行。
這個錯誤另外還有幾種常見成因值得排查:
<script> 標籤放在了引用它的自訂腳本之後,載入順序顛倒。noConflict() 釋放 $ 佔用,此時應改用 jQuery 而非 $。遇到時先用瀏覽器開發者工具的 Network 面板確認 jQuery 是否成功載入,往往能快速定位問題。