症狀很詭異:jQuery 明明引入成功,控制台也沒跳錯誤,但圖片滾動就是不動。最後的解法甚至不是改程式碼,而是改檔案編碼。
一開始會直覺懷疑是 <iframe> 的問題。因為把滾動那段程式碼單獨抽成一個頁面、再用 iframe 嵌進首頁時,它就能正常顯示;直接寫在首頁裡反而不行。這個現象很容易讓人誤判為 iframe 有某種神奇的隔離效果。
但 iframe 能運作只是巧合——單獨抽出來的檔案剛好用了正確的編碼儲存。
該頁面的 HTML 宣告為 gb2312,而 jQuery 相關的 JavaScript 檔案卻存成了 UTF-8(或反之)。當編碼不匹配時,瀏覽器會用錯誤的字碼表解讀位元組,於是:
註解或字串裡的中文字被解成亂碼;
某些位元組序列被誤判為語法符號,破壞了字串或程式的結構;
更糟的情況是檔案中出現了無法解析的位元組,導致整個腳本在編譯階段就失敗。
而編譯階段的失敗不一定會在頁面上明顯報錯——尤其是當錯誤發生在外部檔案、又被某些環境靜默處理時,你只會看到「什麼都沒發生」。
把所有相關檔案統一存成 UTF-8,問題立刻消失。具體要做三件事:
一、檔案本身:用編輯器把 HTML、JS、CSS 全部另存為「UTF-8(不帶 BOM)」。帶 BOM 的檔案在某些伺服器與舊瀏覽器上會產生額外的隱藏字元,反而製造新問題。
二、頁面宣告:在 <head> 最前面加上 <meta charset="utf-8">,並確保它落在前 1024 位元組內,否則瀏覽器可能已經用錯誤編碼開始解析了。
三、伺服器回應標頭:確認 Content-Type 帶有 ;charset=utf-8。HTTP 標頭的優先級高於 meta 標籤,兩者衝突時以標頭為準,這也是很多人「明明設了 meta 卻還是亂碼」的原因。
在瀏覽器的開發者工具裡開啟 Network 面板,點進該 JS 檔看回應標頭的 Content-Type,再對照編輯器右下角顯示的檔案編碼。兩者不一致,就是兇手。另一個線索是:用亂碼編碼打開該 JS 檔,中文註解會變成問號或黑色菱形——若程式碼中有中文字串,這個錯誤會直接影響執行結果。