DIV CSS 佈局教程網

Firefox 報 illegal character 並顯示亂碼?先檢查 JS 檔案編碼
編輯:關於JavaScript     

在 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 宣告,能杜絕這一整類難以定位的錯誤——因為它的表現形式是亂碼與莫名錯誤,往往會被誤判為程式邏輯問題,白白浪費排查時間。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved