在 Firefox 中開啟頁面,主控台突然丟出一堆看不懂的錯誤,畫面上也出現亂字——這個問題通常和程式邏輯無關,而是檔案編碼出了差錯。
錯誤訊息大致長這個樣子:
錯誤: illegal character 源文件:file:///F:/MyDocument/jquery-126all.js 行:1,列:4 源代碼:昨湵瑣潩⡮笩⼊ਪ⨠樠畑牥...
值得注意的是三個線索:出錯位置在第一行、也就是檔案最開頭;「源代碼」欄位顯示的是完全不成詞的方塊與怪字;而且錯誤類型是 illegal character 而非語法錯誤。
這代表瀏覽器用錯誤的編碼去解讀了這個 .js 檔。當檔案實際上是 UTF-8 或 GB2312 編碼,卻被當成另一種編碼解析時,中文字元會被拆成不合理的位元組序列,其中某些位元組剛好落在 JavaScript 語法不允許的範圍,於是就報出 illegal character。
常見的觸發情境包括:檔案含有中文註解或中文字串(例如 alert("中文提示")),而專案其他部分的編碼宣告與之不一致;或者編輯器存檔時使用了與宣告不同的編碼。
1. 確認檔案實際編碼:用支援編碼檢視的編輯器(Notepad++、VS Code 等)打開,看狀態列顯示的是什麼。再用 file -i yourfile.js 這類指令交叉驗證。
2. 統一專案編碼:最省事的做法是全專案統一為 UTF-8,並在 HTML 中加入 <meta charset="utf-8" />,同時確認伺服器回應標頭的 Content-Type 也標明正確的 charset。
3. 轉存檔案:用記事本開啟後另存並選擇 UTF-8;或在 Visual Studio 中「另存新檔」,點擊「儲存」按鈕右側的下拉箭頭,選擇編碼方式後再儲存。
4. 若外部函式庫本身有問題:確認下載來源與版本是否正確,必要時重新下載一份編碼乾淨的檔案。
把「編碼」當作專案設定的一部分,而不是每次存檔時才臨時決定。統一的 UTF-8 加上明確的 meta 宣告,能杜絕這一整類難以定位的錯誤——因為它的表現形式是亂碼與莫名錯誤,往往會被誤判為程式邏輯問題,白白浪費排查時間。