這個錯誤幾乎每個前端都撞過。瀏覽器給的訊息只有一句 $ is not defined 或 jQuery is not defined,但背後的原因可以差很多。以下依發生頻率整理五種常見情況與解法。
最單純的原因。可以用瀏覽器開發工具的 Network 面板確認請求是否存在。另外,如果你是用某些「整站下載器」把靜態頁面存到本機,相對路徑的 src 常常會被改寫成無效位置,導致檔案其實沒載入成功。建議直接從官方網站下載,或使用可信的 CDN。
在頁面原始碼中點一下 script 標籤的 src,瀏覽器會試圖開啟那個檔案——開不了就是路徑有問題。有些工具會自動在路徑前塞入額外前綴,也會造成同樣的結果。
JavaScript 是逐段解析執行的語言。$ 這個別名是 jQuery 掛在全域的物件,你的程式碼在它之前執行,自然就找不到它。
正確做法有兩點:把 jQuery 的 script 標籤放在所有依賴它的 script 之前;並且把使用到 jQuery 的程式碼包進 ready 裡,確保 DOM 已經就緒。
<script type="text/javascript" src="path/to/jquery.min.js"></script>
<script type="text/javascript">
$(document).ready(function () {
// 依賴 jQuery 的程式碼寫在這裡
});
</script>
使用第三方 CDN 雖然快,但把關鍵函式庫的可用性交給別人,本質上是一種風險。CDN 節點故障、DNS 被污染、網路逾時,都會讓 jQuery 載不進來。
實務上常見的解法是「CDN 優先、本地備援」:
<script src="https://cdn.staticfile.org/jquery/3.1.1/jquery.min.js"></script>
<script>
window.jQuery || document.write('<script src="/js/jquery.min.js"><\/script>');
</script>
這段寫法的邏輯是:如果 CDN 成功載入,window.jQuery 就有值,備援不會觸發;一旦 CDN 失敗,才動態寫入本機的 script 標籤補上。絕大多數使用者仍能享受 CDN 的快取加速,而 CDN 出問題時也不至于整頁功能失效。
還有幾種零星原因值得一併檢查:jQuery 被引入兩次且版本衝突,導致某個外掛掛在舊版本上而找不到方法;外掛腳本在 jQuery 之前載入;使用 defer 或 async 屬性打亂了原本的執行順序;以及在 <head> 裡直接執行 DOM 操作,元素還不存在。
除錯順序建議由外而內:先看 Network 面板確認 jQuery 請求是 200 而且內容不是錯誤頁,再看 Console 裡錯誤發生的檔案與行號,最後才去懷疑邏輯。九成的 jQuery is not defined 都能在這兩步內定位。
以上就是這題的完整梳理,希望對你的除錯有所幫助。