在VS Code ESLint扩展中启用Node原生TypeScript配置加载支持

背景介绍

随着ESLint对TypeScript支持能力的不断增强，最新版本已经能够通过Node.js原生TypeScript加载器直接解析eslint.config.ts配置文件。这一功能为开发者带来了更流畅的TypeScript项目配置体验，不再需要依赖第三方转译工具。

技术实现原理

该功能依赖于Node.js的两个实验性特性：

1. --experimental-strip-types：用于在运行时处理TypeScript类型注解
2. --unstable_native_nodejs_ts_config：启用Node.js原生的TypeScript配置加载能力

在命令行环境中，开发者可以通过以下方式启用这些特性：

NODE_OPTIONS='--experimental-strip-types' eslint . --flag unstable_native_nodejs_ts_config

VS Code集成配置

要在VS Code的ESLint扩展中使用这一功能，需要进行以下配置调整：

1. 指定Node.js运行时版本

由于这些特性仅在Node.js 22.x及以上版本中可用，而VS Code默认捆绑的是Node.js 20.x，因此需要显式指定使用本地安装的新版本Node.js：

{
  "eslint.runtime": "node"
}

2. 配置实验性参数

通过eslint.execArgv传递Node.js运行时参数，以及通过eslint.options.flags传递ESLint特定标志：

{
  "eslint.execArgv": ["--experimental-strip-types"],
  "eslint.options": {
    "flags": ["unstable_native_nodejs_ts_config"]
  }
}

3. 完整配置示例

将上述配置组合起来，完整的VS Code设置应如下所示：

{
  "eslint.runtime": "node",
  "eslint.execArgv": ["--experimental-strip-types"],
  "eslint.options": {
    "flags": ["unstable_native_nodejs_ts_config"]
  }
}

注意事项

1. 环境重启：修改配置后，需要完全重启VS Code窗口（而不仅仅是重启ESLint服务器）才能使更改生效。

2. 版本兼容性：确保本地安装的Node.js版本为22.x或更高，否则这些实验性特性将不可用。

3. 稳定性考虑：由于使用的是实验性特性，在生产环境中应谨慎评估其稳定性。

技术优势

相比传统的Jiti加载方式，使用Node.js原生TypeScript加载器具有以下优势：

1. 性能提升：减少了一层转译过程，加载速度更快
2. 兼容性更好：直接使用Node.js内置的TypeScript处理能力
3. 调试方便：错误堆栈更清晰，便于问题排查

总结

通过合理配置VS Code ESLint扩展，开发者可以充分利用最新的Node.js原生TypeScript配置加载能力，为TypeScript项目提供更高效、更稳定的代码检查体验。随着这些特性的逐渐稳定，未来有望成为TypeScript项目的标准配置方式。