unicode-bom
要求或禁止 Unicode 位元組順序標記 (BOM)
🔧 可修復
此規則回報的某些問題可透過 --fix
命令列選項自動修復
Unicode 位元組順序標記 (BOM) 用於指定程式碼單元是大端還是小端。也就是說,最高位元組或最低位元組是否先出現。UTF-8 不需要 BOM,因為當字元是單一位元組時,位元組順序並不重要。由於 UTF-8 是網路上主要的編碼方式,因此我們將 "never"
作為預設選項。
規則詳細資訊
如果使用 "always"
選項,此規則要求檔案必須始終以 Unicode BOM 字元 U+FEFF 開頭。如果使用 "never"
,則檔案絕不能以 U+FEFF 開頭。
選項
此規則有一個字串選項
"always"
檔案必須以 Unicode BOM 開頭"never"
(預設) 檔案不得以 Unicode BOM 開頭
always
使用 "always"
選項時,此規則的正確程式碼範例
在遊樂場中開啟
// U+FEFF at the beginning
/*eslint unicode-bom: ["error", "always"]*/
var abc;
使用 "always"
選項時,此規則的不正確程式碼範例
在遊樂場中開啟
/*eslint unicode-bom: ["error", "always"]*/
var abc;
never
使用預設 "never"
選項時,此規則的正確程式碼範例
在遊樂場中開啟
/*eslint unicode-bom: ["error", "never"]*/
var abc;
使用 "never"
選項時,此規則的不正確程式碼範例
在遊樂場中開啟
// U+FEFF at the beginning
/*eslint unicode-bom: ["error", "never"]*/
var abc;
何時不該使用它
如果您使用一些 UTF-16 或 UTF-32 檔案,並且您想要允許檔案選擇性地以 Unicode BOM 開頭,則應關閉此規則。
版本
此規則是在 ESLint v2.11.0 中引入的。