安装Node.js v20.13.1(LTS)后执行npm -v报错的解决方法

核心原因 #

全局npm目录（C:\Users\alexc\AppData\Roaming\npm\node_modules\npm）文件损坏，常规卸载Node.js不会自动清理该目录，导致重装后仍调用损坏文件。

修复步骤 #

• 清理残留文件

  1. 关闭所有Node.js/npm相关进程
  2. 执行命令删除全局npm目录：rmdir /s /q C:\Users\alexc\AppData\Roaming\npm
  3. 删除用户目录下的npm配置文件（如果存在）：del C:\Users\alexc\.npmrc

• 重新安装Node.js

  1. 下载Node.js v20.13.1 LTS安装包，选择完整安装并确保勾选"Add to PATH"
  2. 安装完成后重启命令提示符（必须使用新窗口）

• 验证修复
  执行node -v确认版本为v20.13.1，再执行npm -v检查是否正常输出版本号

备选方案（上述步骤无效时） #

• 用Node.js内置命令强制重装npm：

  node -e "require('npm').install(['npm@latest'], {global: true})"
  

• 自定义全局npm目录：
  1. 创建新目录如C:\npm-global和C:\npm-cache
  2. 设置npm配置：

     npm config set prefix "C:\npm-global"
     npm config set cache "C:\npm-cache"
     

  3. 将C:\npm-global添加到系统环境变量PATH
  4. 执行npm install -g npm@latest完成重装

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