Vite+React项目npm run dev报??=语法错误及VS Code Node版本问题求助

问题根源 #

??=是ES2020引入的空值赋值运算符，Node.js 14.12版本未完全支持该语法，而VS Code终端默认加载了Node 14.12，导致执行npm run dev时出现语法错误。核心问题是VS Code未使用系统已安装的Node v20.12.2版本。

解决步骤 #

1. 确保VS Code终端继承系统环境变量 #

• 打开VS Code，按Ctrl+,打开设置，搜索terminal.integrated.env.[你的系统]（Windows对应terminal.integrated.env.windows，macOS对应terminal.integrated.env.osx，Linux对应terminal.integrated.env.linux）。
• 点击「编辑 in settings.json」，添加或修改配置，让终端继承系统的PATH：

  "terminal.integrated.env.windows": {
    "PATH": "${env:PATH}"
  }
  

• 保存设置后，关闭并重启VS Code终端。

2. 检查版本管理器（如nvm、n）的默认配置 #

• 如果使用nvm，在VS Code终端执行nvm list查看已安装版本，确认默认版本是否为v20.12.2。
• 若默认版本不是目标版本，执行nvm alias default 20.12.2设置默认版本。
• 检查用户目录下的配置文件（如.bashrc、.zshrc、Windows的系统属性-环境变量），确保没有自动切换到Node 14.12的脚本或环境变量配置。

3. 清除项目本地的版本锁定 #

• 检查项目根目录是否存在.nvmrc文件，若文件内指定了14.12，删除该文件或修改为20.12.2。
• 打开package.json，查看engines字段，若存在"node": "14.12.x"，删除该字段或修改为">=20.12.2"。

4. 手动指定VS Code的Node路径（备选方案） #

• 打开VS Code设置，搜索node.path，点击「编辑 in settings.json」。
• 添加你的Node安装路径，示例：

  // Windows
  "node.path": "C:\\Program Files\\nodejs\\node.exe"
  // macOS
  "node.path": "/usr/local/bin/node"
  // Linux
  "node.path": "/usr/bin/node"
  

• 保存后重启VS Code。

5. 验证修复结果 #

• 重启VS Code，打开终端执行node -v，确认输出为v20.12.2。
• 执行npm run dev，检查是否仍有语法错误。

内容的提问来源于stack exchange，提问作者Kevin Aguilera