卸载Node.js这件事按理说不难但你真去搜一圈会发现几乎全是“删这里、删那里”的零散回答照着操作下来经常遗漏关键路径尤其是Windows环境下注册表、符号链接、用户目录下的全局安装包哪一处没清干净后患都很大。我自己这些年经手过不少Node.js的安装与卸载问题从早期版本号混乱到后来nvm-windows、nvs这类工具出现再到Windows、macOS、Linux三种系统的删法踩过的坑足够写成一篇文章了。这篇我打算把“卸载”这件事从头到尾拆开讲不光是删目录和跑卸载命令还包括卸载前需要记录什么、卸载后怎么自检、哪些残留会导致下一次安装失败以及几个非常容易让人误判的“伪卸载成功”情况。先说清楚这里讲的主要场景有这么几类一是你当前机器上Node.js版本乱到没法用了想彻底清掉重装二是开发环境升级新旧项目依赖冲突需要换版本管理方案三是装了一堆全局工具包想重新整理四是完全不用Node了希望清理干净。不管哪一种只要按我下面的步骤走完基本能做到“系统里像从没装过一样”同时又不会误删你其他依赖的东西。1. 动手之前先把现状摸清楚1.1 你到底为什么要卸载卸载最忌讳的是一上来就开删。建议先花两分钟想清楚这次卸载之后你是打算换版本安装还是彻底不用了或者是切换成nvm这类版本管理工具。不同目标对应不同的清理深度。如果是换版本重装那全局依赖的清单必须提前备份否则装完新版后会发现自己丢了一堆不知道怎么重装的工具包。如果是彻底不用那卸载完还要检查系统环境变量、用户配置文件保证命令行不再出现node、npm字样。如果是切换到nvm管理那么原目录虽然要删但全局包有没有必要保留得先想清楚。我自己遇到过很多次用户说“卸载了怎么node -v还能用”结果一看根本不是正常安装路径是nvm软链接或者用户目录下的缓存目录还在。这个在后面排查章节会细讲。1.2 先备份记录当前有效信息不管你想删得多干净卸载之前还是建议把下面这些信息记录下来万一需要重装这些是“后悔药”。node -v npm -v where node where npm npm config list npm root -g在Linux或者macOS上对应的是which node which npm npm config list npm root -g这里简单解释一下每条命令的作用node -v、npm -v告诉你当前装的什么版本。where node/which node找出可执行文件的实际路径后面清理目录全靠它定位。npm root -g显示全局node_modules路径这是最容易漏掉的。npm config list列出npm配置来源里面有cache路径、prefix路径等对后续清理和备份很有用。如果用上了nvm还需要执行nvm list看看本地装了哪些Node版本以及当前默认版本指向谁。1.3 备份全局工具包清单对开发机来说比较肉疼的是全局安装的包例如npm、yarn、pnpm、rimraf、typescript、vue-cli、create-react-app、pm2、eslint等。这些全局包在卸载重装之后都需要重新安装但你不一定记得当时装没装、装的什么版本所以先导出一份清单npm list -g --depth0Windows下可以这样备份到文件npm list -g --depth0 global-packages.txtmacOS/Linux则用npm list -g --depth0 global-packages.txt同时把npm config list里的内容也复制出来特别是registry源地址、proxy配置、cache路径、prefix路径。等重装完直接照着设置能少走很多弯路。有同学会问全局node_modules的文件夹能不能直接备份复制等重装完再拷回去。理论上可以但我不推荐因为很多原生模块编译时绑定的是特定Node版本换了Node大版本之后C扩展模块不兼容照样得重新编译复制回去反而更麻烦。2. Windows系统卸载实操2.1 首选官方安装包卸载Windows下最稳妥的卸载方式是回到安装时用的那个安装包。如果你保留了msi文件或者知道自己当初是通过官网安装包装的那么双击这个安装包安装向导会让你选择“Remove”或“Repair”。选择Remove后跟着走就行会自动删除主目录、注册表项和系统环境变量。如果找不到原安装包也不用慌系统设置里的“应用和功能”页面会列出Node.js选中后点“卸载”同样会调用官方卸载程序。这里有个小细节卸载程序跑完之后界面可能不会提示你重启但注册表变更需要等一段时间才能完全生效环境变量在现有命令行窗口里不会刷新必须新开一个终端窗口验证。不过官方卸载程序并不是把文件删得一干二净。它删除的是安装目录和注册表里它自己写的那部分用户目录下的缓存数据、npm全局安装目录、环境变量里用户手动改过的东西未必能完全清理。所以卸载程序跑完还得自己手动清一轮。2.2 手动清理安装目录和缓存Windows下默认安装路径通常是C:\Program Files\nodejs\如果你当初自定义过安装目录那就去对应路径删。如果担心删错先打开路径确认一下里面是不是有node.exe、npm.cmd、npx.cmd确认无误再删。然后是用户目录下的npm相关文件这里要特别注意区分%APPDATA%\npm一般情况下是C:\Users\你的用户名\AppData\Roaming\npmnpm全局可执行文件的目录很多全局工具的命令脚本都在这里。%APPDATA%\npm-cache即C:\Users\你的用户名\AppData\Roaming\npm-cachenpm的默认cache目录这个文件夹会随着你安装依赖越积越大。%LOCALAPPDATA%\npm-cache有的npm版本会把cache放在Local目录也需要清理。%APPDATA%\nodejs个别安装场景会出现。%LOCALAPPDATA%\Programs\nodejs有些nvm-windows或手动安装时会用到的路径。还有一个非常容易被忽略的隐藏目录就是用户主目录下的.npmrc文件路径是C:\Users\你的用户名\.npmrc。这个文件可能设置过prefix、cache、registry、proxy等配置如果不删除重装之后还会影响npm的全局路径指向。之所以强调手动清理这些目录是因为它们保存了数据即使装好新版Node也不会自动被覆盖反倒是旧配置可能影响新版本的全局目录。这里建议按这个顺序来打开C:\Program Files\nodejs\确认后删除整个文件夹。打开%APPDATA%删除npm文件夹和npm-cache文件夹。打开%LOCALAPPDATA%同样清理npm-cache。删除用户目录下的.npmrc文件如果你的自定义配置想保留就备份后改名而不是删除。删除C:\Users\你的用户名\AppData\Roaming\npm\node_modules在没有全局包时这个目录可能不存在。2.3 处理环境变量开始菜单搜索“环境变量”打开“编辑系统环境变量”在“高级”页签里点击“环境变量”。检查下面这些内容用户变量里面的PATH或Path逐条查找有没有...\nodejs\、...\npm、...\AppData\Roaming\npm等条目有就选中删掉。这里要小心不要把C:\Windows或者其他软件路径误删了。系统变量里面的NODE_PATH如果有直接删除。这个变量通常不是必须存在的它在你手动设置全局模块路径时需要。系统变量里的PATH或Path同样查找nodejs相关路径。改系统变量需要管理员权限改完点确定之后最好重启一下电脑或至少注销一次让环境变量彻底刷新。清理环境变量有个经验每次删之前都先把当前Path完整的复制到一个文本文件里万一误删还能恢复。这个建议适用于所有系统不光是Windows。2.4 清理注册表可选但建议做官方卸载程序一般会删除注册表里Node.js相关的项但如果你在安装期间配置过自定义路径、或者曾经中途安装失败过注册表里可能会有残留项其中最典型的是[HKEY_CURRENT_USER\Software\Node.js]和[HKEY_LOCAL_MACHINE\SOFTWARE\Node.js]。不建议新手直接用注册表编辑器乱删。比较稳妥的做法是只在“shell:startup”里检查是否有关Node.js相关的自启动项或者在“服务”管理器里查找名字里含“node”的服务其余注册表清理可以在卸载程序跑完、手动确认命令无法使用后再去处理。如果确实需要清理注册表请先备份注册表再搜索“Node.js”和“nodejs”两个关键词确认是Node.js相关键值后逐一删除。3. macOS系统卸载实操3.1 先判断安装方式macOS下Node.js的安装方式非常多有官网pkg安装包、Homebrew、nvm、fnm、直接编译源码还有各种一键脚本。不同安装方式对应的卸载命令完全不同第一步先确认你当初是怎么装的否则后面容易白干。快速判断方法如果/usr/local/bin/node存在且你记得点过.pkg安装包大概率是官方包安装。如果执行brew list | grep node有输出说明是通过Homebrew安装的。如果~/.nvm目录存在或者nvm ls能输出版本列表说明是nvm管理的。3.2 Homebrew安装的卸载方式Homebrew安装的Node.js卸载最简单brew uninstall --ignore-dependencies node brew cleanup如果你还装过带有版本号的旧版formula比如node16也要一并卸载brew uninstall --ignore-dependencies node16--ignore-dependencies参数的意思是即使其他软件依赖Node也强制卸载。有时候不常用这个参数会报错提示有依赖包。如果确认这些依赖包如yarn也需要删除那就不加这个参数直接brew uninstall node让Homebrew自己处理依赖关系。卸载完记得检查一下/usr/local/opt/node之类的软链接一般Homebrew卸载时会一并处理但偶尔会残留。3.3 pkg安装包的卸载官网pkg安装包安装的正常应该在/usr/local/bin目录下面有node和npm的符号链接实际操作中这些链接各有指向。官方卸载脚本在安装包里有提供不过它隐藏得很深需要从安装包内提取。传统做法是重新下载相同版本的.pkg安装包。用pkgutil --expand解包找到Distribution文件里的preinstall或postinstall脚本执行里面的卸载逻辑。或者直接参考脚本里的路径列表手工删除。手工删除主要针对这些路径sudo rm -rf /usr/local/bin/node sudo rm -rf /usr/local/bin/npm sudo rm -rf /usr/local/bin/npx sudo rm -rf /usr/local/lib/node_modules sudo rm -rf /usr/local/include/node sudo rm -rf /usr/local/share/doc/node sudo rm -rf /usr/local/share/man/man1/node.1 sudo rm -rf ~/.npm sudo rm -rf ~/.npmrc sudo rm -rf ~/.config/nodejs同时需要清除pkg的安装记录sudo pkgutil --forget org.nodejs.node.pkg如果安装的是较新版本Node 16以后的pkg包包里含的卸载脚本比这个清单更全但手工方式至少覆盖90%的情况。注意macOS下有些符号链接可能在/usr/local/bin/node - ../Cellar/node/XX/bin/node如果是Homebrew装的路径会不一样。所以在执行rm -rf之前用ls -l /usr/local/bin/node看清楚链接指向。3.4 清理环境变量和shell配置文件macOS下的环境变量通常写在~/.zshrc默认zsh或~/.bash_profile、~/.bashrc里打开后查找类似下面几行export PATH/usr/local/bin:$PATH export NVM_DIR$HOME/.nvm如果是pkg安装包装的NodePATH配置一般没写进shell配置文件因为它默认写到/usr/local/bin这个目录已经在系统PATH里了。如果是nvm或源码编译安装配置文件里大概率会有NVM_DIR或者自定义node路径需要手动删掉。修改完shell配置后执行source ~/.zshrc或者新开一个终端窗口让配置生效。还有一点macOS的/Library/Receipts目录下可能有安装包记录/private/etc/paths.d下也可能有node相关路径文件同样需要检查。4. Linux系统卸载实操4.1 区分包管理器安装和二进制包安装Linux发行版众多Node.js的安装方式主要分两类包管理器安装apt、yum、dnf、pacman等安装后由系统包管理器管理和卸载。二进制压缩包安装直接从nodejs.org下载tar.xz或tar.gz解压后配置PATH使用。这类卸载就是删目录、删环境变量。4.2 Debian/Ubuntu系apt卸载sudo apt remove nodejs sudo apt purge nodejs sudo apt autoremoveremove只删除程序本身purge会把配置文件也删掉autoremove清理依赖。如果当初是通过NodeSource的仓库安装的可能还需要删除apt源文件sudo rm /etc/apt/sources.list.d/nodesource.list4.3 CentOS/RHEL/Fedora系yum/dnf卸载sudo yum remove nodejs # 或者 sudo dnf remove nodejs同样检查/etc/yum.repos.d/下是否有nodesource相关的repo文件。4.4 源码编译或二进制包安装的卸载这类安装方式没有统一的卸载命令等于手动装到了某个目录比如/usr/local/node或/opt/node。卸载时需要注意软链接和PATH。# 找到 node 实际路径 which node # 如果指向 /usr/local/bin/node并且这是个软链接 ls -l /usr/local/bin/node # 删除软链接和主目录 sudo rm -rf /usr/local/nodePATH环境变量里的node路径通常在/etc/profile、/etc/profile.d/、~/.bashrc、~/.zshrc、~/.profile里搜索包含node的行确认后删除或注释。4.5 如果用了nvmnvm管理的Node.js卸载单个版本nvm ls nvm uninstall 16.20.0彻底卸载nvm本身只需要删除~/.nvm目录然后在shell配置里删掉NVM_DIR相关的三行配置。nvm不需要再执行其他卸载命令这一点比包管理器还干净。5. 残留文件深度清理与验证5.1 全平台残留位置速查写到这我把三平台最常见的残留位置整理成一张表方便对照排查平台位置说明通用npm缓存目录Windows%APPDATA%\npm-cache或%LOCALAPPDATA%\npm-cachemacOS/Linux~/.npm通用npm全局安装目录Windows%APPDATA%\npm\node_modulesmacOS/Linux/usr/local/lib/node_modules或/usr/lib/node_modules通用npm配置文件~/.npmrcWindows还在用户目录下通用全局bin目录Windows%APPDATA%\npmmacOS/Linux/usr/local/bin下node、npm、npx软链接Windows安装主目录C:\Program Files\nodejs\Windows用户级临时文件目录%TEMP%\npm-*、%TEMP%下的node相关临时文件macOSpkg安装记录/var/db/receipts/org.nodejs.*Linuxapt源配置/etc/apt/sources.list.d/nodesource.list通用Electron/工具缓存~/AppData/Roaming/Electron、~/Library/Caches等5.2 环境变量核对清单再次强调环境变量的检查很多“卸载不干净”的案例最后都栽在这。Windows下系统属性 - 高级 - 环境变量。在用户变量和系统变量里各搜索node、npm、nodejs关键字。删除形如C:\Program Files\nodejs\、%APPDATA%\npm等路径。保存后重启命令行或重启电脑。macOS/Linux下echo $PATH | tr : \n | grep -i node如果输出中仍有Node相关路径就挨个找到来源文件并清理。配置文件中常见的就是export PATH...node/bin:$PATH、export NVM_DIR...等。5.3 验证卸载结果清理完成后需要做一次“残留自检”。新开终端窗口执行node -v npm -v正常情况下会提示node: command not found或npm: command not found。如果还能输出版本号说明系统中还有一个node在PATH可搜索范围内回到where node/which node继续追踪来源。在Windows上还要注意PowerShell可能有别名或缓存node -v输出的内容有时候会误导你。建议用Get-Command node | Format-List *查看真实路径。而在macOS/Linux上如果which node显示的路径在/usr/local/bin但ls -l查看后发现它指向一个刚才没删掉的目录那就继续删除那个目录。还需要确认以下几点npm config get prefix是否还指向已删除的目录。用注册表编辑器在Windows下搜索“nodejs”试试残留键值需要管理员权限谨慎操作。重启一次电脑后再次运行node -v确保“重启后依然不可用”这才算卸载干净。6. 常见问题与排查实录6.1 卸载之后node命令还能用这个问题出现的频率极高原因有几个一是nvm等版本管理工具的“软链接”没删。Windows下的nvm-windows装完后C:\Program Files\nodejs其实是一个指向nvm目录的符号链接不删它node就一直可用。macOS/Linux下同理nvm的bin目录会被加到PATH里。二是用户变量和系统变量混了。卸载程序可能只清理了系统变量但用户变量里还挂着node路径新开的终端会优先合并两边PATH。三是命令行工具缓存。Windows下用PowerShell的话输入node会先走命令哈希表缓存如果node.exe已经被删除但缓存仍指向原路径会有“暂时的假象”。解决办法是执行Get-Command node看路径或者直接重启终端再试。6.2 报错 node:util does not provide an export named这个问题很典型的场景是卸载旧版Node后重装了新版但项目里用的是旧版本的语法或者全局工具包还是老版本调用node:util时找不到新的导出接口。实际上“does not provide an export named”这个报错多数时候和“卸载不干净”没直接关系而是版本兼容性问题。比如老项目用了require(util).promisify在较新Node版本下某些内部模块结构调整再配合旧版npm registry源更新不及时就容易在安装依赖时触发这个错。遇到这种情况正确办法是清掉项目里的node_modules和package-lock.json重新执行npm install如果还不行试试升级或锁定Node到项目要求的版本范围看package.json里的engines字段。不要因为看到“node”字样就觉得是卸载残留问题先看报错堆栈里的调用来源。6.3 提示“The requested module node:... does not provide...”和上面类似这个报错通常是新版Node对ESMECMAScript Modules的处理更严格了。某些旧包以CommonJS方式引用了Node内置模块在Node 18的环境下就会因为导出名称变更而失败。排查方法是查看node版本node -v如果是18以上很多老包需要升级到兼容版本。查看报错来自哪个依赖看堆栈里的require或import来源再决定是升级包版本还是锁Node版本。这提醒我们一件事卸载旧Node后重装最好别直接装最新大版本而是看项目实际要求。很多生产项目至今还在用16或18 LTS没必要赶20、24的车。6.4 提示“v2x.y.z is not yet released or is not available”这个错误常出现在通过nvm安装特定版本时。比如你看到了一个版本号v24.21.0但实际这个版本根本不存在或者还没有正式发布到官方版本列表里。这不是卸载导致的问题而是版本列表缓存或手滑多打了数字。解决办法nvm ls-remote查看真实可安装的版本列表选择其中明确存在的版本号。如果列表很旧先执行nvm install --lts更新列表缓存再查看。6.5 Windows下卸载后安装新版失败提示已存在这种情况非常典型。旧版没删干净新版安装程序在检测时发现已有安装就拒绝继续安装或者安装完成后发现node -v依旧是旧版本。原因通常是旧的C:\Program Files\nodejs文件夹还在但卸载程序已把注册表项删了导致新安装包既识别不到旧版本、也无法覆盖。注册表里手动添加过Path路径安装时没有自动移除。Windows Installer缓存C:\Windows\Installer里有残留的.msi信息导致冲突。解决办法先按第二章手动删除目录再清理注册表项尤其是[HKLM\SOFTWARE\Node.js]和[HKCU\Software\Node.js]清理完再运行新安装包。如果安装包依然提示“已安装”可以试试从添加或删除程序里修复一下再卸载或使用Windows Installer CleanUp Utility之类的专用清理工具。6.6 npm命令还存在但node命令消失了这个大概率是PATH里还有%APPDATA%\npm但node.exe所在的主目录已经从PATH删掉了。npm全局bin目录里有很多.cmd脚本即使node.exe没了命令行解析器依然能找到npm.cmd但它运行时因为没有node解释器报错会提示“node 不是内部或外部命令”。这种情况下卸载本身已经算做完了只需要把PATH里的%APPDATA%\npm一并删除即可。同理macOS/Linux下如果npm命令还在但node不见了检查/usr/local/share/npm/bin、/usr/local/bin/npm等路径下的npm软链接是否已清理。6.7 清理过程权限不足删不掉文件Windows下删除C:\Program Files\nodejs时经常碰到权限问题尤其是安装包的某些目录加了隐藏的保护属性。这时候建议以管理员身份打开PowerShell或命令提示符。先关闭正在使用Node进程的终端、开发工具、编辑器、任务管理器里所有的node.exe进程。taskkill /f /im node.exe然后再删除目录。macOS/Linux下则是加sudo或者先chmod改属性再删。7. 一些操作心得卸载Node.js这件事本质上不是“删一个软件”而是“清理一个带有全局状态、跨平台路径和版本管理器的生态系统”。你可以把Node.js想成一套精装修的房子安装时往墙上打了各种膨胀螺丝还接了水电卸载时不只是把家具搬走膨胀螺丝、管线、甚至墙纸都要弄干净否则下次装修的师傅一打孔就会碰壁。个人建议日常开发环境尽量从一开始就用版本管理工具Windows下nvm-windows、macOS/Linux下nvm这样卸载单个版本只需要一条命令完全不需要手动清目录。如果真的走到了手动卸载这一步那么上面几章的路径清单建议大家保存好以后在不同系统上重装、切换版本时能省很多事。最后再分享一个小技巧清理完以后不要急着装新版先重启一次系统Windows尤其必要然后用node -v、npm -v确认已失效再去官网下载装新版。这样最少能避免一半的“卸载不干净”问题。如果你是在帮别人处理电脑尽量记录下原来的node版本号和全局包清单别让人家丢了工具链这也是作为技术人最基本的责任感。
