安装Node.js v20.14.0后NPM无法使用，提示找不到validate-engines.js模块

问题详情 #

• 安装方式：通过.msi安装包安装Node.js v20.14.0
• 需求：使用NPM全局安装json-server
• 异常表现：Node运行正常，但执行任何NPM命令时抛出模块缺失错误，具体报错如下：

node:internal/modules/cjs/loader:1148
throw err;
^

Error: Cannot find module './cli/validate-engines.js'
Require stack:
- C:\Users\Arthur\AppData\Roaming\npm\node_modules\npm\lib\cli.js
- C:\Users\Arthur\AppData\Roaming\npm\node_modules\npm\bin\npm-cli.js
    at Module._resolveFilename (node:internal/modules/cjs/loader:1145:15)
    at Module._load (node:internal/modules/cjs/loader:986:27)
    at Module.require (node:internal/modules/cjs/loader:1233:19)
    at require (node:internal/modules/helpers:179:18)
    at Object.<anonymous> (C:\Users\Arthur\AppData\Roaming\npm\node_modules\npm\lib\cli.js:1:25)
    at Module._compile (node:internal/modules/cjs/loader:1358:14)
    at Module._extensions..js (node:internal/modules/cjs/loader:1416:10)
    at Module.load (node:internal/modules/cjs/loader:1208:32)
    at Module._load (node:internal/modules/cjs/loader:1024:12)
    at Module.require (node:internal/modules/cjs/loader:1233:19) {
  code: 'MODULE_NOT_FOUND',
  requireStack: [
    'C:\\Users\\Arthur\\AppData\\Roaming\\npm\\node_modules\\npm\\lib\\cli.js',
    'C:\\Users\\Arthur\\AppData\\Roaming\\npm\\node_modules\\npm\\bin\\npm-cli.js'
  ]
}

• 已尝试的无效操作：卸载Node.js、执行安装包的修复功能

解决步骤 #

1. 彻底清理NPM与Node.js残留文件 #

• 打开CMD执行以下命令，获取NPM全局模块路径：

  npm root -g
  

  输出应为C:\Users\Arthur\AppData\Roaming\npm\node_modules
• 关闭所有CMD、终端、IDE窗口（避免文件被占用）
• 手动删除以下路径：
  • C:\Users\Arthur\AppData\Roaming\npm
  • C:\Users\Arthur\AppData\Roaming\npm-cache
  • Node.js的安装目录（默认是C:\Program Files\nodejs或C:\Program Files (x86)\nodejs）
• 检查系统环境变量PATH，移除任何旧的Node.js/NPM相关路径，确保仅保留正确的安装目录路径

2. 重新安装Node.js #

• 下载Node.js v20.14.0的.msi安装包，右键选择以管理员身份运行
• 安装过程中选择Complete（完整安装），确保勾选"Add to PATH"选项
• 安装完成后重启电脑，确保环境变量生效

3. 验证修复效果 #

• 打开新的CMD窗口，执行以下命令确认版本：

  node -v
  npm -v
  

• 尝试安装json-server：

  npm install -g json-server
  

4. 备选方案（若上述步骤无效） #

• 无需全局安装，直接用npx运行json-server：

  npx json-server --watch db.json
  

• 若能正常执行npm命令，可强制更新NPM到最新版本：

  npm install -g npm@latest
  

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