运行JavaScript项目时Node.js 12版本来源排查求助

• 检查项目根目录的**.nvmrc**文件：很多项目会通过这个文件指定Node版本，若里面写了12.x，直接修改为16.x即可。
• 查看**package.json**的engines字段：如果存在如下配置，会强制限制Node版本，把12替换为16

  "engines": {
    "node": "12.x"
  }
  

• 排查项目构建脚本：打开package.json的scripts字段，确认构建命令是否硬编码了Node 12的路径，比如/usr/local/bin/node12 ./build.js，改成当前Node 16的路径或直接用node命令。
• 检查IDE/编辑器终端配置：比如VS Code的终端，是否单独配置了Node版本，或是终端别名把node指向了旧版本。
• 核对系统环境变量：确认PATH里仅保留Node 16的路径，无残留的Node 12相关路径。可在终端运行echo $PATH（Linux/macOS）或echo %PATH%（Windows）查看。
• 清理项目本地版本管理残留：检查项目内是否有.volta或.node-version文件，这类文件也会指定Node版本，直接删除或修改为16版本即可。
• 清空构建工具缓存：执行npm cache clean --force清理npm缓存，若使用webpack、vite等工具，手动删除node_modules/.cache目录。

如果以上步骤都排查完毕仍有问题，在终端运行which node（Linux/macOS）或where node（Windows），确认输出为Node 16的路径；再运行node -v验证版本，之后在项目根目录重新执行npm install，再尝试构建。

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