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

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

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

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

官方安装包(.msi/.pkg/.tar.gz)包管理器(Homebrew/APT/YUM)版本管理工具(nvm、n)

二、Windows 系统卸载 Node.js

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

按下 Win + R → 输入 appwiz.cpl → 找到以下条目并卸载:

Node.jsnpm(如果独立安装)

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

删除安装目录(默认路径):C:\Program Files\nodejs

清理用户数据:# 删除 npm 全局包和缓存

C:\Users\<你的用户名>\AppData\Roaming\npm

C:\Users\<你的用户名>\AppData\Roaming\npm-cache

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

步骤 3:清理环境变量

右键“此电脑” → 属性 → 高级系统设置 → 环境变量。删除以下条目:

Path 中的 C:\Program Files\nodejs用户变量中的 NODE_PATH(如果存在)

三、macOS 系统卸载 Node.js

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

删除主程序:sudo rm -rf /usr/local/{bin/{node,npm},lib/node_modules}

方法 2:通过 Homebrew 卸载

卸载 Node.js 和 npm:brew uninstall node@16 node@18 # 按实际版本卸载

brew cleanup --prune=all

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

先卸载 nvm 本身:rm -rf ~/.nvm

然后编辑 Shell 配置文件:nano ~/.zshrc # 或 ~/.bash_profile

删除或注释以下内容:export NVM_DIR="$HOME/.nvm"

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

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

rm -rf ~/.npm

rm -rf ~/.node-gyp

四、Linux 系统卸载 Node.js

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

Debian/Ubuntu:sudo apt purge nodejs npm

sudo apt autoremove

CentOS/RHEL:sudo yum remove nodejs npm

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

删除 Node.js 主目录:sudo rm -rf /usr/local/lib/node_modules

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

方法 3:通过 nvm 卸载

列出已安装版本并删除:nvm ls # 查看所有版本

nvm uninstall 18 # 卸载指定版本

rm -rf ~/.nvm # 完全删除 nvm

步骤 4:清理残留文件

rm -rf ~/.npm

rm -rf ~/.cache/node-gyp

五、验证是否卸载成功

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

node -v # 应提示 "command not found"

npm -v # 同上

npx -v # 同上

六、附加提醒

全局包备份:

卸载前可备份全局包列表:npm list -g --depth=0 > npm_global_packages.txt

IDE 集成清理:

VSCode:卸载 ESLint、Prettier 等依赖 Node.js 的扩展。

系统级残留检查:# Linux/macOS 检查残留符号链接

which node # 应无输出

七、常见问题解决

卸载后终端仍显示 Node.js 版本:

执行 hash -r(Linux/macOS)或重启终端。检查是否有其他安装路径:where node(Windows)或 which node(macOS/Linux)。

重装时报权限错误:

确保残留目录(如 /usr/local/lib/node_modules)已彻底删除。

八、总结

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

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

相关作品

[交流]关于抓大鬼蓝书攻宠技能问题
365体育手机版官网

[交流]关于抓大鬼蓝书攻宠技能问题

📅 09-23 👁️ 7362
全民用车
365体育投注怎么玩

全民用车

📅 09-15 👁️ 7809
Microsoft 日语输入法
365bet在线

Microsoft 日语输入法

📅 08-22 👁️ 9628