版本

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

資源

變更語言