Node.js安装后npm缺失，执行npm --v报Cannot find module错误求助

问题描述 #

安装Node.js v20.12.2后，执行node -v可正常显示版本，但执行npm --version时出现以下错误：

PS C:\Users\sarath> npm --version
node:internal/modules/cjs/loader:1146
  throw err;
  ^

Error: Cannot find module 'C:\Users\sarath\AppData\Roaming\npm\node_modules\npm\bin\npm-cli.js'
    at Module._resolveFilename (node:internal/modules/cjs/loader:1143:15)
    at Module._load (node:internal/modules/cjs/loader:984:27)
    at Function.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:135:12)
    at node:internal/main/run_main_module:28:49 {
  code: 'MODULE_NOT_FOUND',
  requireStack: []
}

重装Node.js后问题依旧。

解决步骤 #

1. 修复环境变量配置 #

• 打开系统环境变量：右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
• 在用户变量的Path中，删除C:\Users\sarath\AppData\Roaming\npm这条路径（如果存在）
• 在系统变量的Path中，确认是否存在Node.js安装目录（默认是C:\Program Files\nodejs），没有则添加该路径
• 重启终端，执行npm --version测试

2. 手动重装npm #

• 执行以下命令，利用Node.js内置的npm模块重新安装全局npm：

  node -e "const { execSync } = require('child_process'); execSync('npm install -g npm', { stdio: 'inherit' })"
  

• 如果上述命令失败，直接调用Node.js内置的npm-cli.js执行安装：

  node "C:\Program Files\nodejs\node_modules\npm\bin\npm-cli.js" install -g npm
  

  （注意：如果你的Node.js安装路径不同，替换上述命令中的路径）

3. 清理npm残留文件 #

• 删除用户目录下的.npmrc配置文件（路径：C:\Users\sarath\.npmrc）
• 删除C:\Users\sarath\AppData\Roaming\npm和C:\Users\sarath\AppData\Roaming\npm-cache两个文件夹
• 重启终端后再次测试npm --version

4. 重新安装完整Node.js包 #

• 卸载当前Node.js，下载对应版本的离线.msi安装包（避免使用在线安装包）
• 安装时务必勾选「Add to PATH」选项，安装路径不要包含中文或特殊字符
• 安装完成后重启终端验证npm是否正常

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