現象:頁面裡明明已經把 jQuery 引入進來了,但原本運作正常的 JavaScript 卻集體失效,控制台也沒有明確的錯誤指向。
回頭檢查引入的那一行,發現是這樣寫的:
<script type="text/javascript" src="resources/js/jquery/jquery-1.9.1.min.js" />
關鍵就在結尾那個自封閉的斜線。script 標籤在 HTML 中並不是空元素,它必須有明確的結束標籤。瀏覽器看到 /> 時並不會把它當成正常的閉合,而是繼續往後吞內容,直到勉強找到某個 </script> 為止——結果就是 jQuery 沒被正確載入,後續所有依賴它的程式碼全部報 $ is not defined。
把自封閉改成成對的開閉標籤即可:
<script type="text/javascript" src="resources/js/jquery/jquery-1.9.1.min.js"></script>
改完重新整理,一切恢復正常。
這個坑在 XHTML 風格的 Coding habit 下特別容易出現,因為其他標籤(如 <img />、<link />)寫成自封閉完全沒問題,久而久之就養成了習慣。但 script 是個例外:即使 src 已經指定了外部檔案,標籤內容仍須成對存在。記住這一點,能省下不少排查時間。