如何在Visual Studio 2022+ESLint9.10中覆盖内置Node.js版本

问题背景 #

在Visual Studio 2022（版本升级至17.10.6）开发TS/TSX项目时，安装的ESLint 9.10始终使用VS内置的Node.js v16.14启动，即使系统已安装v21.7.3。ESLint 9.x要求Node.js 18+，导致兼容性问题。

已尝试的无效方法包括：调整VS外部工具顺序、使用NVM切换版本、添加.nvmrc文件、创建.vscode/settings.json指定eslint.runtime、修改.eslintrc/eslint.config.mjs等。

可行解决方案 #

1. 调整VS外部Web工具优先级（核心解决方法） #

VS的外部工具顺序决定了它优先使用哪个Node版本：

• 打开 Tools > Options > Projects and Solutions > Web Package Management > External Web Tools
• 将系统Node.js的安装路径（例如C:\Program Files\nodejs，或NVM管理的版本路径C:\Users\<你的用户名>\.nvm\versions\node\v21.7.3\）移至列表最顶部，确保在$(VSInstalledExternalTools)之前
• 重启Visual Studio生效

2. 配置项目级ESLint运行时（针对VS2022） #

VS2022不识别.vscode/settings.json，需在项目根目录的.vs文件夹下创建settings.json（若.vs文件夹不存在则新建），内容如下：

{
  "eslint.runtime": "C:\\Program Files\\nodejs\\node.exe"
}

替换路径为你的Node.js可执行文件的实际路径。

3. 强制使用本地ESLint安装 #

确保项目依赖中安装了ESLint 9.10：

npm install eslint@9.10 --save-dev

然后在VS中开启本地ESLint：

• 打开 Tools > Options > Text Editor > JavaScript/TypeScript > Linting > General
• 勾选Enable ESLint，同时勾选Use ESLint version from the node_modules folder

验证方法 #

重启VS后，打开View > Output，在输出窗口的下拉菜单中选择ESLint，查看启动日志，确认Node.js版本是否为你指定的v21.7.3。

注意事项 #

• 不要直接替换VS内置的Node.js文件，VS的部分核心组件（如TypeScript语言服务）依赖内置的v16.14，强行替换会引发兼容性问题。
• ESLint 9.x使用扁平配置（eslint.config.mjs）时，确保配置文件中没有依赖Node.js v16的插件或规则。

内容的提问来源于stack exchange，提问作者Kristian Oye