命令行卸载Node.js？正确姿势是什么？

卸载 Node.js 需根据操作系统选择对应方法，以下是 Windows、macOS、Linux 的完整步骤，涵盖手动清理残留文件的关键细节，操作前请备份项目依赖（如 package.json）和全局包列表（执行 npm list -g --depth=0 记录）。

卸载前的准备

1. 记录全局安装的包（避免重装后丢失）：

   npm list -g --depth=0 > npm_global_packages.txt

2. 备份项目依赖：
   检查项目目录中的 package.json 和 node_modules（如需保留）。

按操作系统卸载步骤

▍ Windows 系统
👉 方法1：通过安装程序卸载

1. 打开 控制面板 > 程序和功能
2. 找到 Node.js → 右键选择 卸载。

👉 方法2：命令行强制卸载

1. 以管理员身份打开 CMD 或 PowerShell：

   # 列出所有 Node.js 版本，获取卸载标识符
   wmic product where "name like 'Node.js%%'" get name, identifyingnumber
   # 根据标识符卸载（将 XXXXX 替换为实际值）
   msiexec /x {XXXXX} /qn

2. 手动删除残留文件（关键步骤）：

   # 删除安装目录（默认路径）
   rmdir "C:\Program Files\nodejs" /s /q
   # 删除用户数据
   rmdir "%AppData%\npm" /s /q
   rmdir "%AppData%\npm-cache" /s /q
   # 清理环境变量
   # 右键"此电脑" > 属性 > 高级系统设置 > 环境变量
   # 删除 Path 中的 `C:\Program Files\nodejs\`

▍ macOS 系统
👉 方法1：使用 Homebrew 卸载

1. 如果通过 Homebrew 安装：

   brew uninstall node
   brew cleanup

👉 *方法2：手动彻底删除（推荐）

1. 删除 Node.js 主程序：

   sudo rm -rf /usr/local/bin/npm
   sudo rm -rf /usr/local/bin/node

2. 清理全局包和缓存：

   sudo rm -rf /usr/local/lib/node_modules
   sudo rm -rf ~/.npm
   sudo rm -rf ~/.node-gyp

3. 检查 /usr/local/include 和 /usr/local/share：

   sudo rm -rf /usr/local/include/node*
   sudo rm -rf /usr/local/share/man/man1/node.1

▍ Linux 系统
👉 方法1：通过包管理器卸载

• APT (Debian/Ubuntu)：

  sudo apt purge --auto-remove nodejs npm
  sudo rm -rf /etc/apt/sources.list.d/nodesource.list  # 移除源

• YUM (CentOS/Fedora)：

  sudo yum remove nodejs npm
  sudo rm -rf /etc/yum.repos.d/nodesource*.repo

👉 方法2：手动删除（适用于二进制安装）

1. 定位 Node.js 安装路径：

   which node  # 输出如 /usr/local/bin/node

2. 删除相关文件：

   sudo rm -rf /usr/local/bin/npm
   sudo rm -rf /usr/local/bin/node
   sudo rm -rf /usr/local/lib/node_modules
   sudo rm -rf ~/.npm

验证卸载是否成功

执行以下命令应返回 “未找到命令”：

node -v    # 检查 Node.js
npm -v     # 检查 npm
npx -v     # 检查 npx

常见问题解决

• 卸载后命令仍存在？ → 重启终端或系统，确保环境变量更新。
• 权限错误 → 在命令前加 sudo（Linux/macOS）或以管理员运行 CMD（Windows）。
• 安装新版本失败 → 彻底删除旧版本残留文件（重点检查 /usr/local/ 和用户目录）。

后续建议

1. 重装最新版：推荐使用 nvm（跨平台版本管理工具）：

   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
   nvm install --lts  # 安装最新 LTS 版本

2. 恢复全局包：

   xargs npm install -g < npm_global_packages.txt

引用说明：本文方法参考 Node.js 官方文档、npm 社区实践及系统包管理器标准流程，操作涉及系统级变更，建议结合 Node.js 官方安装指南 执行。
安全提示：谨慎执行 rm -rf 命令,避免误删系统文件。