unicode-bom
要求或禁止 Unicode 字节顺序标记 (BOM)
🔧 可修复
此规则报告的某些问题可以通过 --fix
命令行 选项自动修复
Unicode 字节顺序标记 (BOM) 用于指定代码单元是大端还是小端。也就是说,最高有效字节还是最低有效字节先出现。UTF-8 不需要 BOM,因为当字符为单字节时,字节顺序无关紧要。由于 UTF-8 是 Web 的主要编码,我们将 "never"
作为默认选项。
规则详情
如果使用 "always"
选项,则此规则要求文件始终以 Unicode BOM 字符 U+FEFF 开头。如果使用 "never"
,则文件绝不能以 U+FEFF 开头。
选项
此规则有一个字符串选项
"always"
文件必须以 Unicode BOM 开头"never"
(默认)文件不得以 Unicode BOM 开头
始终
使用 "always"
选项时,此规则的正确代码示例
在 Playground 中打开
// U+FEFF at the beginning
/*eslint unicode-bom: ["error", "always"]*/
let abc;
使用 "always"
选项时,此规则的不正确代码示例
在 Playground 中打开
/*eslint unicode-bom: ["error", "always"]*/
let abc;
从不
使用默认 "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 中引入。