# 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

此规则使用 "always" 选项的正确代码示例:

/*eslint unicode-bom: ["error", "always"]*/

U+FEFF
var abc;

带有 "always" 选项的此规则的错误代码示例:

/*eslint unicode-bom: ["error", "always"]*/

var abc;

# never

带有默认 "never" 选项的此规则的正确代码示例:

/*eslint unicode-bom: ["error", "never"]*/

var abc;

带有 "never" 选项的此规则的错误代码示例:

/*eslint unicode-bom: ["error", "never"]*/

U+FEFF
var abc;

# 何时不使用

如果您使用一些 UTF-16 或 UTF-32 文件,并且您希望允许文件可选地以 Unicode BOM 开头,您应该关闭此规则。

Last Updated: 5/13/2023, 8:55:38 PM