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"
選項時,此規則的 正確 程式碼範例
在 Playground 中開啟
// U+FEFF at the beginning
/*eslint unicode-bom: ["error", "always"]*/
let abc;
使用 "always"
選項時,此規則的 錯誤 程式碼範例
在 Playground 中開啟
/*eslint unicode-bom: ["error", "always"]*/
let abc;
never
使用預設 "never"
選項時,此規則的 正確 程式碼範例
在 Playground 中開啟
/*eslint unicode-bom: ["error", "never"]*/
let abc;
使用 "never"
選項時,此規則的 錯誤 程式碼範例
在 Playground 中開啟
// U+FEFF at the beginning
/*eslint unicode-bom: ["error", "never"]*/
let abc;
何時不該使用
如果您使用一些 UTF-16 或 UTF-32 檔案,並且想要允許檔案選擇性地以 Unicode BOM 開頭,則應關閉此規則。
版本
此規則在 ESLint v2.11.0 中引入。