最近帮同事处理了一台“重装 Node.js 后还是旧版本”的 Windows 开发机折腾了大半天最后发现根源就是卸载不彻底。这个问题在 Windows 上太常见了很多人从官网下 .msi 装好 Node.js用完想卸载重装结果在“设置-应用”里点了一下卸载就以为完事了重装后跑node -v一看还是之前的老版本甚至npm命令直接报错。这背后的原因说穿了就是 Node.js 在 Windows 上留下的残留远比你想的要多而这篇文章要解决的就是把这个“彻底卸载”的流程完整走一遍让 Windows 上再也不留一个 node 文件。无论你是被旧版本卡住、想重置开发环境、还是刚接手一台别人用过的电脑打算重新搭环境这份清单都值得照着做一遍。先说明一点下面所有操作都在 Windows 10/11 上验证过涉及的命令同时给出 CMD 和 PowerShell 两种写法避免因为终端不同而卡壳。1. 为什么“卸了又装、装了还是旧版”——残留物的分布地图1.1 先复盘一次翻车现场有次我在一台 Windows 11 机器上做工作交接前任工程师说 Node.js 版本太乱想让我升级。我做的第一件事是到“设置 → 应用 → 已安装的应用”里把 Node.js 卸载然后从官网下载了最新的 LTS 安装包一切都很顺利。装完我顺手打开一个已经开着的终端跑node -v诡异的事情来了——显示的居然是旧版本号而且npm还能用全局包也一个不少就好像刚才的卸载根本没发生过。后来我关掉所有终端重新打开一个全新的 PowerShell 窗口再试node -v才显示新版本。但是问题并没有彻底结束npm ls -g --depth0列出来的全局包是旧环境里带出来的那一堆新装的 Node.js 根本不知道它们存在可命令又能用。这就是典型的“卸载不彻底”现场程序主文件被删了但用户级目录、环境变量、注册表信息全留下来了旧版 Node.js 的“幽灵”还在路径里等着帮你运行命令。1.2 四大残留区程序目录、用户数据、环境变量、注册表要理解为什么卸载不干净得先画一张 Node.js 在 Windows 上的“分布地图”。它从来不是只住在一个文件夹里而是至少分布在四个地方残留区典型位置残留后果程序主目录C:\Program Files\nodejs\重新安装时文件冲突node.exe旧文件残留用户数据目录%AppData%\npm、%LocalAppData%\npm-cache、.npmrc、.node-gyp等全局包还能用但新环境不可控缓存占用磁盘环境变量系统 PATH、用户 PATH 中的C:\Program Files\nodejs\、%AppData%\npm命令优先命中旧路径重装后仍执行旧版本注册表HKLM\SOFTWARE\Node.js、卸载信息项在“应用列表”里看到已卸载的 Node.js 项或者卸载失败你从“设置”里执行的那个卸载本质上只处理了第一项的一部分——通过 Windows Installer 卸载了程序本体后面的三块基本都得手动收尾。1.3 你的安装方式决定了残留的“长相”另一个容易忽略的点是Node.js 在 Windows 上不是只有一种安装方式残留也各不相同。官方.msi安装包会写注册表、创建卸载项、默认装进C:\Program Files\nodejs还会往 PATH 里塞路径是残留最多、但最“有迹可循”的一种。.zip绿色解压版一般放在自定义目录里不写注册表但如果你自己把解压目录加进了 PATH或手动设置了 npm prefix那残留就在环境变量和 npm 配置里。nvm-windows版本管理器它用符号链接把某个版本的 Node.js 挂到固定路径下直接在控制面板里卸载 Node.js 是没用的得通过nvm uninstall来卸不然符号链接和 nvm 目录都会留下。winget/choco/scoop安装卸载应该用原来的包管理器硬删目录会导致包管理器状态不同步。所以下面第 3 步的正文部分我会按安装方式分别说而不是只给一条死命令。2. 动手前的 10 分钟记录版本、备份全局包、确保没有进程占用很多人一上来就直接开删删完才想起来某个全局命令的配置没留底。我建议动手前先花 10 分钟做三件事看起来耽误时间实际上能帮你省下重装后配环境的半天。2.1 把当前全局包清单导出来这个步骤可能是整个卸载流程里最值钱的一步。先打开一个终端执行npm ls -g --depth0把输出存成文本或者截图。这样重装完 Node.js 后你还能照着这份清单把全局工具一个个装回来不用凭记忆回忆自己到底装过什么包。如果你还用了 yarn 或 pnpm顺手把它们的全局清单也导出yarn global list pnpm list -g2.2 备份 npm 配置和命令别名如果你的~/.npmrc里配置过镜像源、代理、缓存路径或公司私有仓库地址这些配置不会因为你卸载 Node.js 而自动消失但也不会自动迁移到新环境最好手动备份。执行以下命令查看当前配置npm config list然后在用户主目录下找到.npmrc文件一般在C:\Users\用户名\.npmrc复制一份到桌面或网盘。如果你配置过全局的 shell 别名比如在 PowerShell profile 里写过Set-Alias npms npm start之类的也要把那个 profile 文件备份一下避免重装后命令习惯被清零。2.3 关掉所有 node.exe 进程这一条最容易被忽略也是“卸载按钮点了半天没反应”的元凶。如果 VS Code 里正开着一个 Node.js 调试会话或者某个命令行工具正在跑本地服务界面上确实看不到 node 窗口但任务管理器里 node.exe 还在跑Windows Installer 会因为文件被占用而拒绝卸载或一直转圈。先打开任务管理器切到“详细信息”面板按进程名排序把所有node.exe进程结束更稳妥的做法是先关掉可能调起 node 的软件VS Code、JetBrains 系 IDE、Git 自带工具等然后在 CMD 里再查一遍tasklist | findstr /i node如果还有输出就得继续清理。在 PowerShell 里还可以用Get-Process node -ErrorAction SilentlyContinue | Stop-Process -Force结束进程这一步做完后续的卸载会顺畅很多这也是我在多台机器上验证下来最管用的经验。3. 按安装方式卸载 Node.js 本体不同装法不同卸法这是整个流程的主干部分。别管你在网上看过多少“先删目录再清注册表”的帖子第一步永远是根据当初的安装方式来卸载本体而不是直接拿文件管理器去删除。3.1 官方 .msi 安装从“设置”走到“程序和功能”最常见的场景是用官方安装包装的。这种安装会在 Windows Installer 里注册卸载项所以最正规的卸载方式是按Win R输入appwiz.cpl打开“程序和功能”或在系统设置里搜“已安装的应用”。找到列表里的Node.js点击“卸载”。跟着卸载向导走完必要时重启。如果你装的是 LTS 版本列表里可能显示为Node.js (LTS)或只显示Node.js认准别卸载错了。在较新的 Windows 11 里“设置 → 应用 → 已安装的应用”里同样能找到对应条目。卸载完成后先不要急着做后面的清理回到C:\Program Files\下看看nodejs文件夹还在不在。正常情况下卸载脚本会删掉大部分文件但因为权限或占用问题经常还残留着node.exe或npm相关文件。如果这个目录还在用管理员权限把它删除rmdir /s /q C:\Program Files\nodejsPowerShell 里写为Remove-Item -Recurse -Force C:\Program Files\nodejs3.2 卸载器失败时的兜底msiexec 静默卸载“设置”里的卸载按钮有时候点了没反应尤其是当 Windows Installer 数据库状态异常时。这时候需要动用 msiexec 来兜底。先用注册表编辑器查一下 Node.js 的卸载项定位 ProductCode。运行regedit依次展开HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall在卸载项里找 DisplayName 是 Node.js 的项复制它的ProductCode值类似{55C7A7F3-...}这种格式。然后在管理员终端里执行msiexec /x {55C7A7F3-...} /qn /norestart/qn表示静默卸载不弹界面/norestart是卸载后不自动重启。如果这个命令执行时报错“这个产品可能已经卸载”那说明注册表里的卸载项是残留垃圾直接清注册表后面第 5 步会讲就好不用和它较劲。3.3 nvm-windows 管理的版本别硬删符号链接现在很多开发者用 nvm-windows 管理多个 Node.js 版本卸载逻辑跟前两种完全不同。如果在 nvm 环境里直接去“设置”里卸载 Node.js卸掉的只是当前激活版本的符号链接nvm 实际管理的版本还在%APPDATA%\nvm目录里动弹不得。正确的做法是在 CMD不是 PowerShellnvm-windows 的脚本在 CMD 下更稳里先查看已装版本nvm list然后用 nvm 卸载指定版本nvm uninstall 版本号比如nvm uninstall 20.11.1如果你打算连 nvm-windows 本身一起卸载还需要在“程序和功能”里卸载 nvm然后手动删掉C:\Users\用户名\AppData\Roaming\nvm目录同时检查C:\Program Files\nodejs这个符号链接是否还在如果还在需要删掉。用 CMD 删除符号链接时要用rmdir C:\Program Files\nodejs注意这里是rmdir而不是del因为它是目录符号链接。这一步非常关键我之前见过有人硬删 nvm 目录后残留的符号链接让新装的 Node.js 怎么都启不来。3.4 .zip 解压版和 winget/choco/scoop 安装版如果当初是用.zip解压版那卸载最直接——把你解压的那个文件夹整个删掉就行。但别忘了一件事当初为了能全局使用 node 命令多半手动把解压目录加进了 PATH 环境变量这个 PATH 里的路径不会自动删除需要到第 5 步处理。如果你是用包管理器装的卸载应该走包管理器的卸载命令不然包管理器的状态会一直认为 Node.js 已安装winget uninstall --id OpenJS.NodeJS.LTSchoco uninstall nodejs -yscoop uninstall nodejs这里要特别提醒一句同一台机器上不要同时用多种安装方式混装多次。最常见翻车组合是“先装了 .msi后来又用 nvm 装了一个版本”结果 PATH 里两条 Node.js 路径互相打架node -v时灵时不灵卸载时也是一团乱麻。如果你正好是这种情况优先保留一种安装方式的管理权其他的全部卸干净再重建。4. 逐目录过一遍用户级残留npm 全局包、缓存、配置和 node-gyp好不容易把 Node.js 本体卸了如果你以为这就结束了那我只能说高兴得太早了。这一节才是真正的重头戏npm 在用户目录下的残留才是让环境“死而不僵”的关键。4.1 全局安装的包AppData 里的 Roaming\npm 和 Local\npmnpm 安装全局包时默认会把可执行命令写到C:\Users\用户名\AppData\Roaming\npm模块本体放到node_modules子目录里。如果你在旧环境装过一堆全局包比如typescript、eslint、nodemon、vue/cli卸载 Node.js 后这个目录依然原样躺在那里而且 PATH 里往往还保留着它的引用于是你不需要安装任何东西旧命令照样能跑——但这会造成一个非常误导性的假象看起来环境很正常实际你已经被旧环境绑架了。所以在把关掉 Node.js 本体后要主动清理这个目录rmdir /s /q %APPDATA%\npm在 PowerShell 里Remove-Item -Recurse -Force $env:APPDATA\npm同时也检查一下%LOCALAPPDATA%\npm有些配置或新版本 npm 会把部分内容写到 Local 下。我的判断标准是两个目录只要有就都清宁可误删也能重装不能让旧包残留。4.2 npm 缓存Local\npm-cache 与 Roaming\npm-cachenpm 的 cache 目录是另一个容易被无视的巨无霸。默认位置一般在C:\Users\用户名\AppData\Local\npm-cache但旧版本 npm 或某些自定义配置也可能把缓存写在C:\Users\用户名\AppData\Roaming\npm-cache。这个目录装久了可能占用几个 GB 甚至十几个 GB卸载时它不会自动消失。清理方法和上面类似rmdir /s /q %LOCALAPPDATA%\npm-cache rmdir /s /q %APPDATA%\npm-cache如果你之前手动用过npm config set cache改过缓存路径那还要去.npmrc里确认具体位置别只删默认路径就以为清完了。4.3 用户级配置文件.npmrc、.config、.node-gyp这些“点开头”的隐藏文件新手最容易漏掉。它们在 Windows 上没有.开头的隐含含义只是普通文件名但默认资源管理器里不显示隐藏文件导致很多人根本不知道它们存在。清理前先看清内容再删.npmrc 是用户级 npm 配置文件里面可能有你费劲找来的注册表地址、镜像源、代理配置所以我不建议直接删而是先备份再删除。位置是C:\Users\用户名\.npmrc除了 .npmrc还有几个目录需要检查C:\Users\用户名\.node-gyp编译原生模块时下载的头文件等缓存卸载后留着没用。C:\Users\用户名\.config某些全局工具如yarn、vue/cli早期版本可能在这里留下配置。C:\Users\用户名\.cachenpm 或 npx 临时缓存可能出现的位置如果你的用户名目录下有这个文件夹建议检查一下哪些是 node 相关工具创建的。4.4 用一条命令批量清理的写法如果你不怕误删想在确认备份之后一次性把这些目录都清掉可以在 PowerShell 管理员模式里写一个循环$paths ( $env:APPDATA\npm, $env:LOCALAPPDATA\npm, $env:LOCALAPPDATA\npm-cache, $env:APPDATA\npm-cache, $env:USERPROFILE\.node-gyp, $env:USERPROFILE\.npmrc ) foreach ($p in $paths) { if (Test-Path $p) { Remove-Item -Recurse -Force $p Write-Host 已删除: $p } }这个脚本的好处是能在同一个窗口里把输出打出来方便你肉眼确认哪些路径真的存在并删掉了。跑完以后建议重启一次电脑因为你可能正开着不少还持有文件句柄的软件重启能把残留的句柄和文件锁彻底释放掉。5. 环境变量和注册表的“最后审讯”PATH、卸载项、Node.js 键上面的目录清理清的是“实体文件”这一节解决的是“路径和元数据”。很多时候你文件全删了、全局包也没了但新装的 Node.js 还是跑不出来问题就出在 PATH 里的死路径指向了一个不存在的目录或者注册表里残留了旧版本的卸载信息让新安装包认为“这个版本我已经装过了”。5.1 把 PATH 里所有 node 相关路径揪出来删掉打开环境变量编辑器的标准路径是按Win S搜索“编辑环境变量”或“编辑系统环境变量”打开后先看“用户变量”里的Path再看“系统变量”里的Path。在 Windows 10/11 上两者都可能有下面这几类残留C:\Program Files\nodejs\ C:\Users\用户名\AppData\Roaming\npm C:\Users\用户名\AppData\Local\npm C:\nvm4w\nodejs凡是和 node、npm、nvm 有关的直接选中删掉。这里有个必须注意的细节打开环境变量编辑器前先别急着用里面“上移/下移”的按钮调整顺序系统 PATH 里的变量支持%USERPROFILE%这类环境变量占位符你可以直接在编辑框里改但不要误删%SystemRoot%这些系统核心路径。如果你想知道当前终端的 PATH 里具体有哪些条可以先跑一条命令看输出echo %PATH%或 PowerShell$env:PATH -split ;输出里只要看到 Node.js 相关路径就说明还没清理干净。修改完环境变量后必须把所有已打开的终端关掉重开新值才会生效——这不是玄学是 Windows 的终端进程在启动时就缓存了环境变量不重开不会刷新。5.2 注册表里藏着卸载信息和 Node.js 的足迹注册表是 Windows 上残留问题的重灾区我在排查“已卸载但应用列表还在”时十有八九就是注册表没清干净。打开regedit按热度从高到低检查这几个位置HKEY_LOCAL_MACHINE\SOFTWARE\Node.jsNode.js 安装时写入的安装路径、版本号等。HKEY_CURRENT_USER\SOFTWARE\Node.js用户级信息。HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall卸载信息列表如果这里还有 Node.js 项系统会以为 Node.js 还在。HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall32 位应用或某些安装包会写在这里。理论上直接右键删除这些键即可但我强烈建议删除前先右键“导出”备份到桌面——导出后即使误删也能双击 .reg 文件恢复这比手工恢复注册表靠谱得多。用命令行也可以删除指定键比如在管理员 CMD 里reg delete HKLM\SOFTWARE\Node.js /f reg delete HKCU\SOFTWARE\Node.js /f这里有个经验如果HKLM\SOFTWARE\Node.js已经被删掉了reg delete会报“找不到指定的注册表项或值”这反而不是坏事说明残留不存在直接忽略即可。5.3 不想手动抠用 Geek Uninstaller 或 Windows 官方疑难解答工具兜底如果你觉得上面的注册表操作太细、风险高也可以用第三方卸载工具来兜底。我试过几个里最顺手的是 Geek Uninstaller——体积小、绿色免安装、卸载后会自动扫描注册表和文件残留扫描结果里你一眼就能看到 nodejs 相关的路径勾选删除就行。它的原理其实和我手动清理的过程一致只是把目录扫描和注册表扫描自动化了。另外还有 Windows 官方的“Microsoft Program Install and Uninstall 疑难解答工具”微软官方提供的一个修补工具专门处理“卸载列表里残留、卸载按钮不能点”的情况。虽然它不保证能清掉 npm 用户目录但能修好一部分 Windows Installer 状态问题值得一试。6. 清完怎么确认真的干净了——完整的验证检查清单清理做到这里你以为结束了还差最后一道工序验证。很多人在清理过程中漏了一个关键细节——验证前必须重开新终端不然终端缓存的环境变量会让你误判现场。6.1 先执行一组“找幽灵”的命令打开一个新的 CMD 窗口不是旧终端依次执行node -v npm -v where node where npm如果全部提示“不是内部或外部命令”或“找不到命令”说明命令层的 PATH 残留已经清干净了。在 PowerShell 里对应命令是Get-Command node, npm, npx -ErrorAction SilentlyContinue如果输出里什么都没有就是好事。如果再跑where.exe node或者Get-Command node仍然能找到命令大概率是 PATH 里还有一条你刚才漏删的路径或者还有人在某个 nvm 目录里放了node.exe。6.2 检查目录与 PATH 输出用资源管理器确认以下路径都不存在C:\Program Files\nodejs %APPDATA%\npm %LOCALAPPDATA%\npm-cache %USERPROFILE%\.node-gyp再用命令确认 PATH 输出里已经没有 node 相关内容echo %PATH%我知道这一步确实有点繁琐但“彻底卸载”这四个字靠的就是这一步一步检查堆出来的确定性。这个验证环节我建议至少完整做一遍因为有一次我在用户机器上就发现C:\Users\用户名\scoop\shims\node.exe这条路径在 PATH 里顽固存在导致怎么删都删不干净——那台机器上曾经用 scoop 装过 Node.js。6.3 顺手确认注册表键已消失还差最后一个确认。打开regedit检查 5.2 小节提到的几个键。如果一个都找不到了说明这次卸载在系统层面确实干净了。为了方便复盘我把检查项汇总成一个清单你可以对照着打钩检查项方法通过标准命令层node -v、npm -v报“不是内部或外部命令”PATHecho %PATH%不含 node/npm 相关路径程序目录资源管理器或Test-PathC:\Program Files\nodejs不存在用户目录资源管理器或Test-Path%APPDATA%\npm等目录不存在注册表regedit检查Node.js 相关键不存在卸载列表appwiz.cpl搜索 node没有 Node.js 项7. 重装 Node.js 时我建议你这样做少走一次弯路既然都花时间把环境清到这个程度了重装的时候也不妨多花两分钟做正确决策。7.1 从 nvm-windows 或官方 LTS 二选一我个人现在的习惯是普通项目开发直接用官方 LTS 安装包简单直接如果经常需要在多个大版本间切换比如老项目要 Node 12、新项目要 Node 20就上 nvm-windows。但一定要记住这两种方式只选一个别混着来。用 nvm-windows 管理的 Node.js日常安装删除都交给 nvm 来管不要再到官网手动下载 .msi 往机器上装了。7.2 恢复全局包和镜像源配置重装完成后第一件事不是立刻写代码而是把之前备份的.npmrc内容恢复回去或者重新设置镜像源npm config set registry https://registry.npmmirror.com然后把第 2 步记录的全局包清单找出来一条条装回去npm install -g typescript eslint nodemon这份清单就是你在卸载前备份的“回报”。7.3 这次记得把“卸载”当一件正经事最后还想说一句我从多次帮别人清理环境里得到的最深刻教训是在 Windows 上安装软件不是问题卸载软件才是问题。很多环境故障的根子都在“上次没卸干净”。所以现在我在任何机器上安装需要写环境变量的开发工具前都会先拍一张 PATH 截图装完包后定期导出全局包清单。等到真的需要重装时哪怕过了半年我也能对着当初的记录把环境丝滑地还原回来。这次清理做完你大可以放心地装上一个全新的 Node.js跑node -v时看到的就是真真切切的“干净版本”。
Windows彻底卸载Node.js指南：清理四大残留区与验证方法
最近帮同事处理了一台“重装 Node.js 后还是旧版本”的 Windows 开发机折腾了大半天最后发现根源就是卸载不彻底。这个问题在 Windows 上太常见了很多人从官网下 .msi 装好 Node.js用完想卸载重装结果在“设置-应用”里点了一下卸载就以为完事了重装后跑node -v一看还是之前的老版本甚至npm命令直接报错。这背后的原因说穿了就是 Node.js 在 Windows 上留下的残留远比你想的要多而这篇文章要解决的就是把这个“彻底卸载”的流程完整走一遍让 Windows 上再也不留一个 node 文件。无论你是被旧版本卡住、想重置开发环境、还是刚接手一台别人用过的电脑打算重新搭环境这份清单都值得照着做一遍。先说明一点下面所有操作都在 Windows 10/11 上验证过涉及的命令同时给出 CMD 和 PowerShell 两种写法避免因为终端不同而卡壳。1. 为什么“卸了又装、装了还是旧版”——残留物的分布地图1.1 先复盘一次翻车现场有次我在一台 Windows 11 机器上做工作交接前任工程师说 Node.js 版本太乱想让我升级。我做的第一件事是到“设置 → 应用 → 已安装的应用”里把 Node.js 卸载然后从官网下载了最新的 LTS 安装包一切都很顺利。装完我顺手打开一个已经开着的终端跑node -v诡异的事情来了——显示的居然是旧版本号而且npm还能用全局包也一个不少就好像刚才的卸载根本没发生过。后来我关掉所有终端重新打开一个全新的 PowerShell 窗口再试node -v才显示新版本。但是问题并没有彻底结束npm ls -g --depth0列出来的全局包是旧环境里带出来的那一堆新装的 Node.js 根本不知道它们存在可命令又能用。这就是典型的“卸载不彻底”现场程序主文件被删了但用户级目录、环境变量、注册表信息全留下来了旧版 Node.js 的“幽灵”还在路径里等着帮你运行命令。1.2 四大残留区程序目录、用户数据、环境变量、注册表要理解为什么卸载不干净得先画一张 Node.js 在 Windows 上的“分布地图”。它从来不是只住在一个文件夹里而是至少分布在四个地方残留区典型位置残留后果程序主目录C:\Program Files\nodejs\重新安装时文件冲突node.exe旧文件残留用户数据目录%AppData%\npm、%LocalAppData%\npm-cache、.npmrc、.node-gyp等全局包还能用但新环境不可控缓存占用磁盘环境变量系统 PATH、用户 PATH 中的C:\Program Files\nodejs\、%AppData%\npm命令优先命中旧路径重装后仍执行旧版本注册表HKLM\SOFTWARE\Node.js、卸载信息项在“应用列表”里看到已卸载的 Node.js 项或者卸载失败你从“设置”里执行的那个卸载本质上只处理了第一项的一部分——通过 Windows Installer 卸载了程序本体后面的三块基本都得手动收尾。1.3 你的安装方式决定了残留的“长相”另一个容易忽略的点是Node.js 在 Windows 上不是只有一种安装方式残留也各不相同。官方.msi安装包会写注册表、创建卸载项、默认装进C:\Program Files\nodejs还会往 PATH 里塞路径是残留最多、但最“有迹可循”的一种。.zip绿色解压版一般放在自定义目录里不写注册表但如果你自己把解压目录加进了 PATH或手动设置了 npm prefix那残留就在环境变量和 npm 配置里。nvm-windows版本管理器它用符号链接把某个版本的 Node.js 挂到固定路径下直接在控制面板里卸载 Node.js 是没用的得通过nvm uninstall来卸不然符号链接和 nvm 目录都会留下。winget/choco/scoop安装卸载应该用原来的包管理器硬删目录会导致包管理器状态不同步。所以下面第 3 步的正文部分我会按安装方式分别说而不是只给一条死命令。2. 动手前的 10 分钟记录版本、备份全局包、确保没有进程占用很多人一上来就直接开删删完才想起来某个全局命令的配置没留底。我建议动手前先花 10 分钟做三件事看起来耽误时间实际上能帮你省下重装后配环境的半天。2.1 把当前全局包清单导出来这个步骤可能是整个卸载流程里最值钱的一步。先打开一个终端执行npm ls -g --depth0把输出存成文本或者截图。这样重装完 Node.js 后你还能照着这份清单把全局工具一个个装回来不用凭记忆回忆自己到底装过什么包。如果你还用了 yarn 或 pnpm顺手把它们的全局清单也导出yarn global list pnpm list -g2.2 备份 npm 配置和命令别名如果你的~/.npmrc里配置过镜像源、代理、缓存路径或公司私有仓库地址这些配置不会因为你卸载 Node.js 而自动消失但也不会自动迁移到新环境最好手动备份。执行以下命令查看当前配置npm config list然后在用户主目录下找到.npmrc文件一般在C:\Users\用户名\.npmrc复制一份到桌面或网盘。如果你配置过全局的 shell 别名比如在 PowerShell profile 里写过Set-Alias npms npm start之类的也要把那个 profile 文件备份一下避免重装后命令习惯被清零。2.3 关掉所有 node.exe 进程这一条最容易被忽略也是“卸载按钮点了半天没反应”的元凶。如果 VS Code 里正开着一个 Node.js 调试会话或者某个命令行工具正在跑本地服务界面上确实看不到 node 窗口但任务管理器里 node.exe 还在跑Windows Installer 会因为文件被占用而拒绝卸载或一直转圈。先打开任务管理器切到“详细信息”面板按进程名排序把所有node.exe进程结束更稳妥的做法是先关掉可能调起 node 的软件VS Code、JetBrains 系 IDE、Git 自带工具等然后在 CMD 里再查一遍tasklist | findstr /i node如果还有输出就得继续清理。在 PowerShell 里还可以用Get-Process node -ErrorAction SilentlyContinue | Stop-Process -Force结束进程这一步做完后续的卸载会顺畅很多这也是我在多台机器上验证下来最管用的经验。3. 按安装方式卸载 Node.js 本体不同装法不同卸法这是整个流程的主干部分。别管你在网上看过多少“先删目录再清注册表”的帖子第一步永远是根据当初的安装方式来卸载本体而不是直接拿文件管理器去删除。3.1 官方 .msi 安装从“设置”走到“程序和功能”最常见的场景是用官方安装包装的。这种安装会在 Windows Installer 里注册卸载项所以最正规的卸载方式是按Win R输入appwiz.cpl打开“程序和功能”或在系统设置里搜“已安装的应用”。找到列表里的Node.js点击“卸载”。跟着卸载向导走完必要时重启。如果你装的是 LTS 版本列表里可能显示为Node.js (LTS)或只显示Node.js认准别卸载错了。在较新的 Windows 11 里“设置 → 应用 → 已安装的应用”里同样能找到对应条目。卸载完成后先不要急着做后面的清理回到C:\Program Files\下看看nodejs文件夹还在不在。正常情况下卸载脚本会删掉大部分文件但因为权限或占用问题经常还残留着node.exe或npm相关文件。如果这个目录还在用管理员权限把它删除rmdir /s /q C:\Program Files\nodejsPowerShell 里写为Remove-Item -Recurse -Force C:\Program Files\nodejs3.2 卸载器失败时的兜底msiexec 静默卸载“设置”里的卸载按钮有时候点了没反应尤其是当 Windows Installer 数据库状态异常时。这时候需要动用 msiexec 来兜底。先用注册表编辑器查一下 Node.js 的卸载项定位 ProductCode。运行regedit依次展开HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall在卸载项里找 DisplayName 是 Node.js 的项复制它的ProductCode值类似{55C7A7F3-...}这种格式。然后在管理员终端里执行msiexec /x {55C7A7F3-...} /qn /norestart/qn表示静默卸载不弹界面/norestart是卸载后不自动重启。如果这个命令执行时报错“这个产品可能已经卸载”那说明注册表里的卸载项是残留垃圾直接清注册表后面第 5 步会讲就好不用和它较劲。3.3 nvm-windows 管理的版本别硬删符号链接现在很多开发者用 nvm-windows 管理多个 Node.js 版本卸载逻辑跟前两种完全不同。如果在 nvm 环境里直接去“设置”里卸载 Node.js卸掉的只是当前激活版本的符号链接nvm 实际管理的版本还在%APPDATA%\nvm目录里动弹不得。正确的做法是在 CMD不是 PowerShellnvm-windows 的脚本在 CMD 下更稳里先查看已装版本nvm list然后用 nvm 卸载指定版本nvm uninstall 版本号比如nvm uninstall 20.11.1如果你打算连 nvm-windows 本身一起卸载还需要在“程序和功能”里卸载 nvm然后手动删掉C:\Users\用户名\AppData\Roaming\nvm目录同时检查C:\Program Files\nodejs这个符号链接是否还在如果还在需要删掉。用 CMD 删除符号链接时要用rmdir C:\Program Files\nodejs注意这里是rmdir而不是del因为它是目录符号链接。这一步非常关键我之前见过有人硬删 nvm 目录后残留的符号链接让新装的 Node.js 怎么都启不来。3.4 .zip 解压版和 winget/choco/scoop 安装版如果当初是用.zip解压版那卸载最直接——把你解压的那个文件夹整个删掉就行。但别忘了一件事当初为了能全局使用 node 命令多半手动把解压目录加进了 PATH 环境变量这个 PATH 里的路径不会自动删除需要到第 5 步处理。如果你是用包管理器装的卸载应该走包管理器的卸载命令不然包管理器的状态会一直认为 Node.js 已安装winget uninstall --id OpenJS.NodeJS.LTSchoco uninstall nodejs -yscoop uninstall nodejs这里要特别提醒一句同一台机器上不要同时用多种安装方式混装多次。最常见翻车组合是“先装了 .msi后来又用 nvm 装了一个版本”结果 PATH 里两条 Node.js 路径互相打架node -v时灵时不灵卸载时也是一团乱麻。如果你正好是这种情况优先保留一种安装方式的管理权其他的全部卸干净再重建。4. 逐目录过一遍用户级残留npm 全局包、缓存、配置和 node-gyp好不容易把 Node.js 本体卸了如果你以为这就结束了那我只能说高兴得太早了。这一节才是真正的重头戏npm 在用户目录下的残留才是让环境“死而不僵”的关键。4.1 全局安装的包AppData 里的 Roaming\npm 和 Local\npmnpm 安装全局包时默认会把可执行命令写到C:\Users\用户名\AppData\Roaming\npm模块本体放到node_modules子目录里。如果你在旧环境装过一堆全局包比如typescript、eslint、nodemon、vue/cli卸载 Node.js 后这个目录依然原样躺在那里而且 PATH 里往往还保留着它的引用于是你不需要安装任何东西旧命令照样能跑——但这会造成一个非常误导性的假象看起来环境很正常实际你已经被旧环境绑架了。所以在把关掉 Node.js 本体后要主动清理这个目录rmdir /s /q %APPDATA%\npm在 PowerShell 里Remove-Item -Recurse -Force $env:APPDATA\npm同时也检查一下%LOCALAPPDATA%\npm有些配置或新版本 npm 会把部分内容写到 Local 下。我的判断标准是两个目录只要有就都清宁可误删也能重装不能让旧包残留。4.2 npm 缓存Local\npm-cache 与 Roaming\npm-cachenpm 的 cache 目录是另一个容易被无视的巨无霸。默认位置一般在C:\Users\用户名\AppData\Local\npm-cache但旧版本 npm 或某些自定义配置也可能把缓存写在C:\Users\用户名\AppData\Roaming\npm-cache。这个目录装久了可能占用几个 GB 甚至十几个 GB卸载时它不会自动消失。清理方法和上面类似rmdir /s /q %LOCALAPPDATA%\npm-cache rmdir /s /q %APPDATA%\npm-cache如果你之前手动用过npm config set cache改过缓存路径那还要去.npmrc里确认具体位置别只删默认路径就以为清完了。4.3 用户级配置文件.npmrc、.config、.node-gyp这些“点开头”的隐藏文件新手最容易漏掉。它们在 Windows 上没有.开头的隐含含义只是普通文件名但默认资源管理器里不显示隐藏文件导致很多人根本不知道它们存在。清理前先看清内容再删.npmrc 是用户级 npm 配置文件里面可能有你费劲找来的注册表地址、镜像源、代理配置所以我不建议直接删而是先备份再删除。位置是C:\Users\用户名\.npmrc除了 .npmrc还有几个目录需要检查C:\Users\用户名\.node-gyp编译原生模块时下载的头文件等缓存卸载后留着没用。C:\Users\用户名\.config某些全局工具如yarn、vue/cli早期版本可能在这里留下配置。C:\Users\用户名\.cachenpm 或 npx 临时缓存可能出现的位置如果你的用户名目录下有这个文件夹建议检查一下哪些是 node 相关工具创建的。4.4 用一条命令批量清理的写法如果你不怕误删想在确认备份之后一次性把这些目录都清掉可以在 PowerShell 管理员模式里写一个循环$paths ( $env:APPDATA\npm, $env:LOCALAPPDATA\npm, $env:LOCALAPPDATA\npm-cache, $env:APPDATA\npm-cache, $env:USERPROFILE\.node-gyp, $env:USERPROFILE\.npmrc ) foreach ($p in $paths) { if (Test-Path $p) { Remove-Item -Recurse -Force $p Write-Host 已删除: $p } }这个脚本的好处是能在同一个窗口里把输出打出来方便你肉眼确认哪些路径真的存在并删掉了。跑完以后建议重启一次电脑因为你可能正开着不少还持有文件句柄的软件重启能把残留的句柄和文件锁彻底释放掉。5. 环境变量和注册表的“最后审讯”PATH、卸载项、Node.js 键上面的目录清理清的是“实体文件”这一节解决的是“路径和元数据”。很多时候你文件全删了、全局包也没了但新装的 Node.js 还是跑不出来问题就出在 PATH 里的死路径指向了一个不存在的目录或者注册表里残留了旧版本的卸载信息让新安装包认为“这个版本我已经装过了”。5.1 把 PATH 里所有 node 相关路径揪出来删掉打开环境变量编辑器的标准路径是按Win S搜索“编辑环境变量”或“编辑系统环境变量”打开后先看“用户变量”里的Path再看“系统变量”里的Path。在 Windows 10/11 上两者都可能有下面这几类残留C:\Program Files\nodejs\ C:\Users\用户名\AppData\Roaming\npm C:\Users\用户名\AppData\Local\npm C:\nvm4w\nodejs凡是和 node、npm、nvm 有关的直接选中删掉。这里有个必须注意的细节打开环境变量编辑器前先别急着用里面“上移/下移”的按钮调整顺序系统 PATH 里的变量支持%USERPROFILE%这类环境变量占位符你可以直接在编辑框里改但不要误删%SystemRoot%这些系统核心路径。如果你想知道当前终端的 PATH 里具体有哪些条可以先跑一条命令看输出echo %PATH%或 PowerShell$env:PATH -split ;输出里只要看到 Node.js 相关路径就说明还没清理干净。修改完环境变量后必须把所有已打开的终端关掉重开新值才会生效——这不是玄学是 Windows 的终端进程在启动时就缓存了环境变量不重开不会刷新。5.2 注册表里藏着卸载信息和 Node.js 的足迹注册表是 Windows 上残留问题的重灾区我在排查“已卸载但应用列表还在”时十有八九就是注册表没清干净。打开regedit按热度从高到低检查这几个位置HKEY_LOCAL_MACHINE\SOFTWARE\Node.jsNode.js 安装时写入的安装路径、版本号等。HKEY_CURRENT_USER\SOFTWARE\Node.js用户级信息。HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall卸载信息列表如果这里还有 Node.js 项系统会以为 Node.js 还在。HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall32 位应用或某些安装包会写在这里。理论上直接右键删除这些键即可但我强烈建议删除前先右键“导出”备份到桌面——导出后即使误删也能双击 .reg 文件恢复这比手工恢复注册表靠谱得多。用命令行也可以删除指定键比如在管理员 CMD 里reg delete HKLM\SOFTWARE\Node.js /f reg delete HKCU\SOFTWARE\Node.js /f这里有个经验如果HKLM\SOFTWARE\Node.js已经被删掉了reg delete会报“找不到指定的注册表项或值”这反而不是坏事说明残留不存在直接忽略即可。5.3 不想手动抠用 Geek Uninstaller 或 Windows 官方疑难解答工具兜底如果你觉得上面的注册表操作太细、风险高也可以用第三方卸载工具来兜底。我试过几个里最顺手的是 Geek Uninstaller——体积小、绿色免安装、卸载后会自动扫描注册表和文件残留扫描结果里你一眼就能看到 nodejs 相关的路径勾选删除就行。它的原理其实和我手动清理的过程一致只是把目录扫描和注册表扫描自动化了。另外还有 Windows 官方的“Microsoft Program Install and Uninstall 疑难解答工具”微软官方提供的一个修补工具专门处理“卸载列表里残留、卸载按钮不能点”的情况。虽然它不保证能清掉 npm 用户目录但能修好一部分 Windows Installer 状态问题值得一试。6. 清完怎么确认真的干净了——完整的验证检查清单清理做到这里你以为结束了还差最后一道工序验证。很多人在清理过程中漏了一个关键细节——验证前必须重开新终端不然终端缓存的环境变量会让你误判现场。6.1 先执行一组“找幽灵”的命令打开一个新的 CMD 窗口不是旧终端依次执行node -v npm -v where node where npm如果全部提示“不是内部或外部命令”或“找不到命令”说明命令层的 PATH 残留已经清干净了。在 PowerShell 里对应命令是Get-Command node, npm, npx -ErrorAction SilentlyContinue如果输出里什么都没有就是好事。如果再跑where.exe node或者Get-Command node仍然能找到命令大概率是 PATH 里还有一条你刚才漏删的路径或者还有人在某个 nvm 目录里放了node.exe。6.2 检查目录与 PATH 输出用资源管理器确认以下路径都不存在C:\Program Files\nodejs %APPDATA%\npm %LOCALAPPDATA%\npm-cache %USERPROFILE%\.node-gyp再用命令确认 PATH 输出里已经没有 node 相关内容echo %PATH%我知道这一步确实有点繁琐但“彻底卸载”这四个字靠的就是这一步一步检查堆出来的确定性。这个验证环节我建议至少完整做一遍因为有一次我在用户机器上就发现C:\Users\用户名\scoop\shims\node.exe这条路径在 PATH 里顽固存在导致怎么删都删不干净——那台机器上曾经用 scoop 装过 Node.js。6.3 顺手确认注册表键已消失还差最后一个确认。打开regedit检查 5.2 小节提到的几个键。如果一个都找不到了说明这次卸载在系统层面确实干净了。为了方便复盘我把检查项汇总成一个清单你可以对照着打钩检查项方法通过标准命令层node -v、npm -v报“不是内部或外部命令”PATHecho %PATH%不含 node/npm 相关路径程序目录资源管理器或Test-PathC:\Program Files\nodejs不存在用户目录资源管理器或Test-Path%APPDATA%\npm等目录不存在注册表regedit检查Node.js 相关键不存在卸载列表appwiz.cpl搜索 node没有 Node.js 项7. 重装 Node.js 时我建议你这样做少走一次弯路既然都花时间把环境清到这个程度了重装的时候也不妨多花两分钟做正确决策。7.1 从 nvm-windows 或官方 LTS 二选一我个人现在的习惯是普通项目开发直接用官方 LTS 安装包简单直接如果经常需要在多个大版本间切换比如老项目要 Node 12、新项目要 Node 20就上 nvm-windows。但一定要记住这两种方式只选一个别混着来。用 nvm-windows 管理的 Node.js日常安装删除都交给 nvm 来管不要再到官网手动下载 .msi 往机器上装了。7.2 恢复全局包和镜像源配置重装完成后第一件事不是立刻写代码而是把之前备份的.npmrc内容恢复回去或者重新设置镜像源npm config set registry https://registry.npmmirror.com然后把第 2 步记录的全局包清单找出来一条条装回去npm install -g typescript eslint nodemon这份清单就是你在卸载前备份的“回报”。7.3 这次记得把“卸载”当一件正经事最后还想说一句我从多次帮别人清理环境里得到的最深刻教训是在 Windows 上安装软件不是问题卸载软件才是问题。很多环境故障的根子都在“上次没卸干净”。所以现在我在任何机器上安装需要写环境变量的开发工具前都会先拍一张 PATH 截图装完包后定期导出全局包清单。等到真的需要重装时哪怕过了半年我也能对着当初的记录把环境丝滑地还原回来。这次清理做完你大可以放心地装上一个全新的 Node.js跑node -v时看到的就是真真切切的“干净版本”。
