--experimental-config-file=config

如果存在，Node.js 将在指定路径中查找配置文件。Node.js 将读取配置文件并应用设置。配置文件应为具有以下结构的 JSON 文件。$schema 中的 vX.Y.Z 必须替换为你使用的 Node.js 版本。

¥If present, Node.js will look for a configuration file at the specified path. Node.js will read the configuration file and apply the settings. The configuration file should be a JSON file with the following structure. vX.Y.Z in the $schema must be replaced with the version of Node.js you are using.

{
  "$schema": "https://nodejs.cn/dist/vX.Y.Z/docs/node-config-schema.json",
  "nodeOptions": {
    "import": [
      "amaro/strip"
    ],
    "watch-path": "src",
    "watch-preserve-output": true
  }
} 拷贝

在 nodeOptions 字段中，仅支持 NODE_OPTIONS 中允许的标志。不支持无操作标志。目前并非所有 V8 标志都受支持。

¥In the nodeOptions field, only flags that are allowed in NODE_OPTIONS are supported. No-op flags are not supported. Not all V8 flags are currently supported.

可以使用 官方 JSON 模式 来验证配置文件，这可能因 Node.js 版本的不同而有所不同。配置文件中的每个键都对应一个可以作为命令行参数传递的标志。密钥的值是将传递给标志的值。

¥It is possible to use the official JSON schema to validate the configuration file, which may vary depending on the Node.js version. Each key in the configuration file corresponds to a flag that can be passed as a command-line argument. The value of the key is the value that would be passed to the flag.

例如，上面的配置文件相当于以下命令行参数：

¥For example, the configuration file above is equivalent to the following command-line arguments:

node --import amaro/strip --watch-path=src --watch-preserve-output 拷贝

配置中的优先级如下：

¥The priority in configuration is as follows:

1. NODE_OPTIONS 和命令行选项

   ¥NODE_OPTIONS and command-line options

2. 配置文件

   ¥Configuration file

3. Dotenv NODE_OPTIONS

配置文件中的值不会覆盖环境变量和命令行选项中的值，但会覆盖由 --env-file 标志解析的 NODE_OPTIONS 环境文件中的值。

¥Values in the configuration file will not override the values in the environment variables and command-line options, but will override the values in the NODE_OPTIONS env file parsed by the --env-file flag.

如果配置文件中存在重复的键，则仅使用第一个键。

¥If duplicate keys are present in the configuration file, only the first key will be used.

如果配置文件包含未知密钥或无法在 NODE_OPTIONS 中使用的密钥，配置解析器将抛出错误。

¥The configuration parser will throw an error if the configuration file contains unknown keys or keys that cannot used in NODE_OPTIONS.

Node.js 不会对用户提供的配置进行清理或验证，因此切勿使用不受信任的配置文件。

¥Node.js will not sanitize or perform validation on the user-provided configuration, so NEVER use untrusted configuration files.