1. 为什么需要彻底卸载Node.js？
在开发过程中，我们经常会遇到Node.js版本冲突、环境变量混乱或安装包损坏的情况。这时候简单的覆盖安装往往无法解决问题，必须彻底卸载后重新安装。根据我的经验，以下场景特别需要完整卸载流程：
- 跨大版本升级（如v14到v18）时，全局模块可能不兼容
- 系统PATH变量被污染导致npm命令不可用
- 安装过程中意外中断导致残留文件
- 需要切换不同的版本管理工具（如从官方安装包改为nvm管理）
重要提示：Windows和macOS的卸载方式有本质区别。Windows需要手动清理注册表，而macOS则需要注意/usr/local目录下的残留文件。
2. 完整卸载Node.js的步骤详解
2.1 Windows系统卸载流程
-
控制面板卸载主程序：
- 打开"设置 > 应用 > 应用和功能"
- 搜索"Node.js"并选择卸载
- 勾选"Automatically remove all dependencies"选项
-
手动清理残留文件：
bash复制# 删除这些目录下的Node.js相关文件夹 C:\Program Files (x86)\Nodejs C:\Program Files\Nodejs C:\Users\{用户名}\AppData\Roaming\npm C:\Users\{用户名}\AppData\Roaming\npm-cache -
注册表清理（需谨慎）：
- 按Win+R输入regedit打开注册表编辑器
- 删除以下路径中的Nodejs相关项：
code复制
HKEY_LOCAL_MACHINE\SOFTWARE\Node.js HKEY_CURRENT_USER\SOFTWARE\Node.js HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\Node.js
2.2 macOS系统卸载流程
-
使用官方卸载脚本：
bash复制curl -o node-uninstall.sh https://raw.githubusercontent.com/Homebrew/install/master/uninstall.sh chmod +x node-uninstall.sh sudo ./node-uninstall.sh -
手动清理残留：
bash复制sudo rm -rf /usr/local/{bin/{node,npm},lib/node_modules/npm,lib/node,share/man/*/node.*} -
检查环境变量：
编辑~/.bash_profile、~/.zshrc等文件，删除所有包含NODE_PATH、NVM_DIR等Node.js相关的环境变量。
3. 全新安装Node.js的最佳实践
3.1 版本选择建议
对于生产环境，我推荐选择LTS（长期支持）版本。可以通过以下命令查看最新LTS版本：
bash复制nvm ls-remote --lts
3.2 Windows安装步骤
-
从官网下载.msi安装包：
code复制https://nodejs.org/dist/v18.16.0/node-v18.16.0-x64.msi -
安装时注意勾选这些选项：
- [x] Add to PATH
- [x] Automatically install necessary tools
- [ ] 不要勾选"Install Chocolatey"（除非你需要）
-
安装完成后验证：
bash复制
node -v && npm -v
3.3 macOS安装推荐方式
建议使用Homebrew管理Node.js：
bash复制brew install node@18
brew link --overwrite node@18
或者使用nvm进行多版本管理：
bash复制curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash
nvm install 18
nvm use 18
4. 安装后必须进行的配置
4.1 npm基础配置
bash复制# 设置淘宝镜像
npm config set registry https://registry.npmmirror.com
# 修改全局安装路径（避免权限问题）
npm config set prefix '~/.npm-global'
# 将新路径加入环境变量
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
4.2 验证安装完整性
创建test.js文件：
javascript复制const http = require('http')
http.createServer((req, res) => {
res.end('Hello Node.js')
}).listen(3000)
然后运行并测试：
bash复制node test.js
# 另开终端执行
curl http://localhost:3000
5. 常见问题解决方案
5.1 EACCES权限错误
bash复制# 重新安装全局包
npm install -g npm@latest --force
# 或者修改npm目录权限
sudo chown -R $(whoami) ~/.npm
5.2 版本混乱问题
如果同时存在多个Node.js版本，建议：
bash复制# 查看实际调用的node路径
which node
# 使用nvm管理不同版本
nvm install 16 && nvm install 18
nvm use 18
5.3 环境变量失效
在Windows中检查PATH顺序：
powershell复制$env:PATH -split ';' | Select-String 'node'
在macOS/Linux中：
bash复制echo $PATH | tr ':' '\n' | grep node
6. 进阶维护技巧
-
定期清理缓存：
bash复制
npm cache clean --force -
使用npx避免全局安装：
bash复制
npx create-react-app my-app -
锁定依赖版本：
在package.json中使用精确版本号：json复制"dependencies": { "lodash": "4.17.21" } -
多项目环境隔离：
bash复制# 使用不同Node.js版本 nvm use 16 # 使用不同npm版本 npm install npm@6 -g
最后分享一个实用命令：查看Node.js模块的磁盘占用情况
bash复制npm list -g --depth=0 | grep -v 'npm@' | awk '{print $2}' | xargs -I {} du -sh $(npm root -g)/{}