一個很典型的狀況:把 JavaScript 寫在外部 .js 檔裡,頁面就是無法正常運作;同樣的程式碼直接貼進 .aspx 檔卻完全正常。這類問題幾乎都不是程式邏輯錯了,而是檔案編碼出了差錯。
外部 js 檔中含有中文註解或中文字串(例如 alert("中文提示"))時,可能出現兩種表現:一是引用完全失效,頁面腳本不執行;二是彈出的訊息變成亂碼。而把方法直接放進 .aspx 頁面則沒有任何問題——這個對比正是編碼問題的典型線索。
.NET 環境在處理文字時有既定的編碼設定。若 .js 檔實際保存為 GB2312(因為裡面有中文),而環境預期的是另一種編碼,瀏覽器解讀位元組時就會產生亂字,其中某些位元組落在 JavaScript 語法不允許的範圍,於是整份腳本解析失敗。
為什麼放在 .aspx 裡就沒事?因為 .aspx 會經過 IIS 的處理管線,回應時帶上正確的 charset 標頭,編碼資訊有明確傳遞;而靜態 .js 檔由 IIS 直接輸出,編碼只能靠檔案本身與頁面宣告來決定。
把 js 檔另存為 UTF-8 或其他 Unicode 編碼,問題即可解決。兩種操作方式:
用記事本:打開檔案,選擇「另存新檔」,在下方「編碼」下拉選單中選擇 UTF-8(或 Unicode)後儲存。
在 Visual Studio 中:選擇「檔案 → 另存新檔」,注意「儲存」按鈕右側有個小箭頭,點開後可選擇編碼方式,選好再儲存。
與其每次出問題才轉檔,不如從專案設定著手:
1. 統一專案編碼為 UTF-8。包含 .js、.css、.html 與原始碼檔全部一致,避免混用。
2. 在 HTML 中明確宣告。於 head 的最前面加上 <meta charset="utf-8" />,並確認它出現在前 1024 位元組內,否則瀏覽器可能忽略。
3. 設定 IIS 的預設編碼。在伺服器或站點層級指定預設文件編碼,讓靜態檔案回應也帶上正確的 Content-Type charset。
4. 考慮把中文訊息外置。將提示文字抽到資源檔或 JSON 語彙檔,程式碼本身只留英文。這樣即使編碼出問題,影響範圍也小得多,同時還順便有助於多語言擴充。
這類問題之所以麻煩,是因為它的表現形式(腳本不執行、訊息亂碼)與編碼八竿子打不著,往往被誤判為語法錯誤而耗費大量時間。養成「先確認編碼」的排查習慣,能省下不少力氣。