程式碼在壓縮/加密後才報錯,是部署階段最惱人的一類問題。九成以上的案例都源自「原本能跑,只是因為直譯器容忍了某種省略寫法,而壓縮工具把它優化掉了」。以下三個要點可以擋掉絕大多數狀況。
JavaScript 有自動分號插入(ASI)機制,行尾會幫你補,但壓縮後換行被移除,ASI 就判斷不出該在哪裡斷句。排查方式是:開啟 IE 的腳本錯誤提示(或任何瀏覽器的開發者工具),載入呼叫 JS 的頁面,它會告訴你缺少分號的位置;接著用編輯器打開壓縮後的檔案跳到該行補上分號,再回到未壓縮的原始碼找到對應位置補好。
// 有風險 var a = 1 var b = 2 // 正確 var a = 1; var b = 2;
這種情況查錯更麻煩。可以用正則 else[a-zA-Z0-9] 在壓縮檔裡搜尋,或直接找 else 後面沒有大括號(或夾著註解)的地方,再回原始碼補上。
// 有風險
if (a > b)
a = b;
else
b = a;
// 正確
if (a > b) {
a = b;
} else {
b = a;
}
// 有風險
function a() {
}
function b() {
}
// 正確
function a() {
};
function b() {
};
同理,這種寫法也該一起補上:
window.onload = function () {
// ...
}; // 結尾一定要有分號
壓縮工具對編碼的處理各家不同,容易把中文字串或註解弄壞。建議在檔案中加上明確的 <meta charset="UTF-8" /> 宣告,並確認壓縮工具以 UTF-8 讀寫;必要時改用複製貼上的方式搬移內容,而不是讓工具重新另存檔案。
與其每次事後補救,不如從源頭避免:專案一律啟用 ESLint(semi、curly 規則)在提交前攔下這些寫法,並用 Terser 這類成熟工具搭配 source map 進行壓縮。有了 source map,就算線上出錯,錯誤堆疊也能對回原始碼的正確行號,不必再手動比對壓縮檔。