← Back to rules

eslint/unicode-bom 限制

An auto-fix is available for this rule.

它的作用

要求或禁止使用 Unicode 字节顺序标记（BOM）

为什么这是不好的？

Unicode 字节顺序标记（BOM）用于指定代码单元是大端还是小端排列。也就是说，是最高有效字节先出现，还是最低有效字节先出现。由于 UTF-8 编码中每个字符仅占一个字节，字节顺序无关紧要，因此不需要 BOM。鉴于 UTF-8 是互联网上主导的编码方式，我们默认采用“从不”允许 BOM 的选项。

示例

此规则下错误代码的示例：

var a = 123;

配置

此规则接受以下字符串值之一：

"always"

始终要求在文件开头包含 Unicode BOM（字节顺序标记）。

"never"

在文件开头绝不允许存在 Unicode BOM（字节顺序标记）。这是默认选项。

如何使用

要通过配置文件或命令行启用此规则，可以使用：

配置文件 (.oxlintrc.json)

{
  "rules": {
    "unicode-bom": "error"
  }
}

CLI

oxlint --deny unicode-bom

参考资料

• 规则源码