版本

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 中引入的。

資源

變更語言