特性标志

ESLint 将实验性和未来可能会发生变化的功能隐藏在特性标志后面，以便用户可以选择他们想要的行为。在以下情况下使用标志：

1. 当某个功能处于实验阶段，尚未准备好供所有人使用时。
2. 当某个功能是重大更改，将在下一个主要版本中正式合并，但用户可以在下一个主要版本之前选择使用该行为时。

标志前缀

标志的前缀指示其状态

• unstable_ 表示该功能处于实验阶段，并且在功能稳定之前实现可能会发生变化。这是一个“自行承担风险”的功能。
• v##_ 表示该功能已稳定，将在下一个主要版本中可用。例如，v10_some_feature 表示这是一个重大更改，将在 ESLint v10.0.0 中正式发布。这些标志在每个主要版本中都会被移除。

如果某个功能是非重大更改，则它可能会在没有主要版本的情况下从不稳定状态变为稳定状态。

活动标志

以下标志目前可在 ESLint 中使用。

标志	描述
test_only	仅用于测试。
unstable_config_lookup_from_file	从正在检查的文件中查找 eslint.config.js。
unstable_ts_config	启用 TypeScript 配置文件。

非活动标志

以下标志曾经使用过，但现在不再活动。

标志	描述
test_only_old	仅用于测试。

如何使用特性标志

由于特性标志是严格的可选功能，因此您需要手动启用您想要的标志。

使用 CLI 启用特性标志

在命令行上，您可以使用 --flag 选项指定特性标志。您可以指定任意数量的标志

npx eslint --flag flag_one --flag flag_two file.js
1

使用 API 启用特性标志

使用 API 时，您可以将 flags 数组传递给 ESLint 和 Linter 类

const { ESLint, Linter } = require("eslint");

const eslint = new ESLint({
    flags: ["flag_one", "flag_two"]
});

const linter = new Linter({
    flags: ["flag_one", "flag_two"]
});
1
2
3
4
5
6
7
8
9

在 VS Code 中启用特性标志

要在编辑器的 VS Code ESLint 扩展中启用标志，请在 settings.json 文件中的 eslint.options 设置中指定您想要的标志

{
  "eslint.options": { "flags": ["flag_one", "flag_two"] }
}
1
2
3

要在 VS Code ESLint 扩展的 lint 任务中启用标志，请指定 eslint.lintTask.options 设置

{
  "eslint.lintTask.options": "--flag flag_one --flag flag_two ."
}
1
2
3