彻底卸载Node.js的跨平台完整指南

1. 为什么需要彻底卸载Node.js？

在开发过程中，我们可能会遇到Node.js版本冲突、安装损坏或需要完全重装环境的情况。常规的卸载方式往往会在系统留下残留文件和配置，导致后续安装新版本时出现各种诡异问题。上周我就因为一个残留的npm全局模块导致新项目依赖解析失败，浪费了整整两小时排查。

彻底卸载Node.js涉及三个关键层面：

• 主程序文件（通常位于/usr/local/bin或Program Files）
• 用户目录下的配置和缓存（如.npmrc、.node-gyp）
• 系统环境变量和注册表项（Windows系统特有）

2. 跨平台卸载操作指南

2.1 Windows系统完整卸载流程

1. 控制面板卸载主程序：

   • 打开"应用和功能"面板
   • 搜索"Node.js"并选择卸载
   • 注意：如果安装了多个版本，需要逐个卸载

2. 手动删除残留文件：

   bash复制# 删除全局npm模块
   rd /s /q "%AppData%\npm"
   rd /s /q "%AppData%\npm-cache"
   
   # 删除Node.js安装目录
   rd /s /q "C:\Program Files\nodejs"
   

3. 清理注册表（需管理员权限）：

   • 运行regedit打开注册表编辑器
   • 删除以下路径（如果存在）：

     code复制HKEY_LOCAL_MACHINE\SOFTWARE\Node.js
     HKEY_CURRENT_USER\SOFTWARE\Node.js
     

警告：操作注册表前建议先导出备份，误删可能导致系统问题

2.2 macOS/Linux系统卸载方案

1. 通过包管理器卸载：

   bash复制# Homebrew安装的Node
   brew uninstall node
   brew cleanup
   
   # Linux apt安装
   sudo apt purge nodejs npm
   sudo apt autoremove
   

2. 手动清理全局文件：

   bash复制# 删除全