清晰易懂的 Node.js 彻底卸载与清理教程_nodejs卸载

一、通用步骤：确认 Node.js 安装方式

Node.js 通常通过以下方式安装：

1. 官方安装包（.msi/.pkg/.tar.gz）
2. 包管理器（Homebrew/APT/YUM）
3. 版本管理工具（nvm、n）

二、Windows 系统卸载 Node.js

步骤 1：通过控制面板卸载主程序

1. 按下 Win + R → 输入 appwiz.cpl → 找到以下条目并卸载：
   • Node.js
   • npm（如果独立安装）

步骤 2：手动删除残留文件

1. 删除安装目录（默认路径）：

   C:\\Program Files\\nodejs

2. 清理用户数据：

   # 删除 npm 全局包和缓存C:\\Users\\\\AppData\\Roaming\\npmC:\\Users\\\\AppData\\Roaming\\npm-cache

   提示：AppData 是隐藏文件夹，需开启“显示隐藏的项目”。

步骤 3：清理环境变量

1. 右键“此电脑” → 属性 → 高级系统设置 → 环境变量。
2. 删除以下条目：
   • Path 中的 C:\\Program Files\\nodejs
   • 用户变量中的 NODE_PATH（如果存在）

三、macOS 系统卸载 Node.js

方法 1：通过官方安装包卸载

1. 删除主程序：

   sudo rm -rf /usr/local/{bin/{node,npm},lib/node_modules}

方法 2：通过 Homebrew 卸载

1. 卸载 Node.js 和 npm：

   brew uninstall node@16 node@18 # 按实际版本卸载brew cleanup --prune=all

方法 3：清理通过 nvm 安装的版本

1. 先卸载 nvm 本身：

   rm -rf ~/.nvm

2. 然后编辑 Shell 配置文件：

   nano ~/.zshrc # 或 ~/.bash_profile

3. 删除或注释以下内容：

   export NVM_DIR=\"$HOME/.nvm\"[ -s \"$NVM_DIR/nvm.sh\" ] && \\. \"$NVM_DIR/nvm.sh\"

步骤 4：删除全局包和缓存

rm -rf ~/.npmrm -rf ~/.node-gyp

四、Linux 系统卸载 Node.js

方法 1：通过包管理器卸载

• Debian/Ubuntu：

  sudo apt purge nodejs npmsudo apt autoremove

• CentOS/RHEL：

  sudo yum remove nodejs npm

方法 2：清理手动安装的版本

1. 删除 Node.js 主目录：

   sudo rm -rf /usr/local/lib/node_modulessudo rm -rf /usr/local/bin/{node,npm,npx}

方法 3：通过 nvm 卸载

1. 列出已安装版本并删除：

   nvm ls # 查看所有版本nvm uninstall 18 # 卸载指定版本rm -rf ~/.nvm # 完全删除 nvm

步骤 4：清理残留文件

rm -rf ~/.npmrm -rf ~/.cache/node-gyp

五、验证是否卸载成功

在终端或命令提示符中运行：

node -v # 应提示 \"command not found\"npm -v # 同上npx -v # 同上

六、附加提醒

1. 全局包备份：
   • 卸载前可备份全局包列表：npm list -g --depth=0 > npm_global_packages.txt
2. IDE 集成清理：
   • VSCode：卸载 ESLint、Prettier 等依赖 Node.js 的扩展。
3. 系统级残留检查：

   # Linux/macOS 检查残留符号链接which node # 应无输出

七、常见问题解决

1. 卸载后终端仍显示 Node.js 版本：
   • 执行 hash -r（Linux/macOS）或重启终端。
   • 检查是否有其他安装路径：where node（Windows）或 which node（macOS/Linux）。
2. 重装时报权限错误：
   • 确保残留目录（如 /usr/local/lib/node_modules）已彻底删除。

八、总结

• Windows：控制面板卸载 → 删除残留目录 → 清理环境变量。
• macOS：区分安装方式 → 清理 nvm → 删除全局缓存。
• Linux：包管理器卸载 → 手动清理符号链接。

按此操作后，Node.js 将被完全清除，为全新安装提供干净环境。建议后续使用 nvm 管理多版本，避免污染系统路径。