企业官网建设流程全解析

Node.js 这个运行时环境，大家装的时候都是照着教程一路下一步，但真要卸的时候，反而容易卡壳。很多人以为删掉安装目录就算完事，结果重装新版本时发现node -v还是旧版本号，或者 npm 全局装的包怎么都清不干净。我前前后后帮同事和自己处理过不少这类卸载残留问题，今天把 Windows 和 macOS 两套系统的完整卸载流程整理出来，每一步都写到能直接照着操作的程度，顺便把为什么这么删、哪些地方容易漏讲清楚。

这篇内容适合所有被 Node.js 环境问题困扰的人，不管是想彻底清掉重装，还是因为版本冲突、npm 全局包污染想回退到干净状态，按下面的步骤走一遍，基本能还你一个“从没装过 Node.js”的系统。

1. 卸载前的必知：Node.js 到底都装了些什么

不先说清楚这一点，后面删起来就是盲人摸象。Node.js 的安装从来不是“一个文件夹”的事，它至少包含四部分内容：主程序文件、npm 全局包、缓存数据、环境变量与注册表项（Windows）或 shell 配置文件（macOS）。

主程序很好理解，就是 node 和 npm 的可执行文件。npm 全局包则是你执行过npm install -g的所有依赖，它们默认被放在一个全局目录里，和 Node.js 主程序目录往往不在同一处。缓存数据是 npm 下载过的压缩包，目的是让你下次安装同样的包时不用再走网络，这些缓存有时候能占到好几个 GB。最后是环境变量，系统靠它来定位 node、npm 命令，卸载后如果不清理，命令行里可能还残留着指向已删除目录的无效路径。

其中最容易被人忽略的是 npm 全局目录。很多人在C:\Program Files\nodejs或/usr/local里找不到自己装过的全局包，就以为删干净了，实际上它们躺在用户目录下。npm 的全局安装目录默认是%APPDATA%\npm（Windows）或/usr/local/lib/node_modules（macOS），删除主程序时不把这些一起清理，后面重装 Node.js 后执行npm ls -g会看到旧包还在，轻则版本混乱，重则包之间依赖冲突。

再有一点，Node.js 官方安装包在 Windows 上还会写入注册表。虽然注册表项主要用于卸载信息，但它也是“系统认为你装过 Node.js”的标志，用控制面板卸载时，卸载程序会负责清理这部分的。如果你之前是用绿色版、zip 解压版安装的 Node.js，那就没有注册表项，清理起来反而更纯粹，只要删目录和改环境变量就够了。

1.1 卸载前建议备份的东西

清理之前的备份工作不能省，特别是下面这三样：

• 项目中的node_modules和package-lock.json。如果你还想继续用这些项目，node_modules没必要手动删，重装 Node.js 后跑一次npm ci就能按package-lock.json精确还原依赖。
• 用 npm 全局装过的、带有个人配置的工具，比如vue-cli、@angular/cli这类脚手架，它们的配置文件可能在~/.vuerc、~/.angular-config.json这类位置。先npm ls -g --depth=0看一眼装了哪些，然后备份对应配置。
• 环境变量里 PATH 的原始值。改 PATH 之前先用echo %PATH%（Windows）或echo $PATH（macOS）把当前值复制存到一个临时文件里，万一改错了能立刻还原，这属于保命操作。

提示：如果你只是某个项目跑不起来，不一定非得卸载 Node.js。可以先试nvm（Node Version Manager）切换版本，或者单独删掉node_modules重装依赖。纯卸载是最后的手段。

2. Windows 平台卸载流程全解

Windows 上的 Node.js 卸载，我习惯按“控制面板 → 残留目录 → npm 缓存和全局包 → 环境变量 → 注册表”这个顺序来。每一步都有对应验证方法，照做就不会漏。

2.1 第一步：通过控制面板卸载主程序

打开控制面板的“程序和功能”，找到 Node.js，右键卸载。这一步会调用 Node.js 自带的卸载程序，把主程序文件和一部分注册表项清掉。

卸载过程如果弹出询问是否删除 npm 缓存之类的勾选项，我建议全选。有些版本的安装包卸载时会给选项，默认是不勾选删缓存的，手动全勾上省得后面再清理。

有一点要强调：卸载程序不一定会把C:\Program Files\nodejs删干净。这个目录里可能残留一些卸载时正在被占用的文件，或者某些子目录结构。所以卸载完成后，先手动检查这个目录是否还存在，存在就直接删除。如果提示文件正在被占用，多半是还有 node 进程在跑，打开任务管理器，把名字带 node 的进程全部结束再删。

2.2 第二步：清理 npm 全局目录

npm 的全局目录默认在%APPDATA%\npm。在资源管理器地址栏输入%APPDATA%\npm回车，可以看到里面都是你之前npm install -g装的包，以及对应的.cmd快捷命令文件。

这个目录直接整个删掉。另外还要检查%APPDATA%\npm-cache和%LOCALAPPDATA%\npm-cache。你可以在地址栏输入这些路径逐一确认。npm-cache 是 npm 的下载缓存，装过越多包，这里越占空间，必须清掉。

如果记不清自己还有没有装过 yarn、pnpm、cnpm 这些包管理器，它们通常也会在%APPDATA%下留下自己的缓存目录。既然是彻底卸载 Node.js，这些相关内容建议一起清理。检查一下%APPDATA%\yarn、%LOCALAPPDATA%\Yarn、%LOCALAPPDATA%\pnpm这类路径，存在就删。

2.3 第三步：清理环境变量

右键“此电脑” → 属性 → 高级系统设置 → 环境变量。在“系统变量”和“用户变量”的 Path 里，找到 Node.js 相关的路径条目，删掉。

常见的需要检查的路径有：

• C:\Program Files\nodejs\
• %APPDATA%\npm
• %APPDATA%\npm-cache
• 如果你之前手动配置过 node 全局路径，比如D:\nodejs或C:\nodejs，这些也要检查

删 Path 条目有个细节：编辑环境变量窗口里，每行一个路径。选中要删的行，点“删除”按钮即可。删之前先截图保存，防止误删其他条目。系统变量和用户变量里都可能有 Node.js 的痕迹，两个列表都要翻一遍。

提示：修改完环境变量后，已经打开的命令行窗口不会自动刷新配置，必须重新开一个新的 cmd 或 PowerShell 窗口才生效。这一点很多人踩坑，改完环境变量后在一个旧窗口里测试，发现 node 命令还在，误以为没删干净。

2.4 第四步：清理注册表项

按Win + R，输入regedit打开注册表编辑器。按下Ctrl + F，搜索nodejs，把找到的相关项和键值删除。搜索时注意看项名，要排除那些只是内容里提到 nodejs、但实际属于其他软件的项。

注册表里主要需要清理的是HKEY_CURRENT_USER\Software\Node.js和HKEY_LOCAL_MACHINE\SOFTWARE\Node.js，删掉这两处基本就干净了。另外建议顺手搜一下npm、npx，看看有没有残留的键值。

操作注册表前务必谨慎。只删和 Node.js 明确相关的项，不确定名称的一律不动。如果对注册表编辑器不熟悉，可以跳过大部分搜索，只删HKCU\Software\Node.js和HKLM\SOFTWARE\Node.js这两个在卸载程序没删干净时可能留下的项。

2.5 第五步：验证卸载结果

完成以上步骤后，新开一个命令行窗口，依次执行以下命令：

node -v npm -v where node where npm

期望的结果是：node和npm都提示“不是内部或外部命令”，where查询也找不到任何可执行文件。如果你看到类似C:\Program Files\nodejs\node.exe的路径输出，说明还有残余，回到前面的清理步骤继续排查。

再检查一下开始菜单里是否还有 Node.js 的快捷方式残留，有就右键删除。有些安装包会在“开始”菜单创建文件夹，删掉整个文件夹即可。

3. macOS 平台卸载流程全解

macOS 上卸载 Node.js 更依赖命令行操作。好在 Mac 的文件系统结构比 Windows 清晰，只要知道删哪些目录就行。

3.1 先确认 Node.js 是怎么装的

macOS 上常见的 Node.js 安装方式有三种：官网 pkg 安装包、Homebrew、nvm 或 fnm 这类版本管理器。不同装法的卸载方式不太一样，要先确认再动手。

在终端执行which node，看输出结果：

• 路径是/usr/local/bin/node，多半是官网 pkg 装的原生版本
• 路径是/opt/homebrew/bin/node（Apple Silicon Mac）或/usr/local/bin/node（Intel Mac），且/opt/homebrew存在，可能是 Homebrew 装的
• 路径下面有nvm字样，比如~/.nvm/versions/node/v18.17.0/bin/node，是用 nvm 装的

确认方式不同，卸载方式完全不同。nvm 装的根本不用手动删目录，执行nvm uninstall <版本号>就完事了。下面重点讲 pkg 和 Homebrew 两种方式。

3.2 pkg 安装版卸载流程

pkg 安装的 Node.js 会散布在/usr/local下多个子目录里，这也是卸载最麻烦的地方。在终端里逐条执行下面的删除命令：

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 /usr/local/share/systemtap/tapset/node.stp sudo rm -rf ~/.npm sudo rm -rf ~/.node-gyp

第一组命令（bin 和 lib 下的）是主程序和 npm 全局包所在位置，第二组是文档和 man page，第三组的~/.npm是 npm 缓存和全局配置，~/.node-gyp是编译原生模块时用的缓存目录。

这里注意：~/.npm里有个_cacache子目录，npm 的下载缓存全在里面。执行了上面的删除命令后，缓存就一起没了。如果只是想清理缓存而保留 Node.js，平时用npm cache clean --force就行，不必删整个~/.npm目录。

3.3 Homebrew 安装版卸载流程

Homebrew 安装的 Node.js 卸载十分简单：

brew uninstall --ignore-dependencies node brew cleanup

--ignore-dependencies参数的存在是因为可能有某些包依赖 node，导致 brew 拒绝卸载。加这个参数可以强制卸载 node 本体。

卸载完后，再手动检查一下/usr/local/lib/node_modules或/opt/homebrew/lib/node_modules是否存在残留。brew 有时不会主动删除某些子目录，存在就手动删掉。

3.4 检查 shell 配置文件里的环境变量

macOS 不设“系统环境变量”这种东西，Node.js 相关路径都写在 shell 配置文件里。不同 shell 对应的文件不同：zsh 是~/.zshrc，bash 是~/.bash_profile或~/.bashrc。

用文本编辑器打开对应文件，搜索node、npm或nvm相关行，把这些 export 语句删掉。其中需要留意的常见配置有：

export PATH="/usr/local/bin:$PATH" export PATH="$HOME/.npm-global/bin:$PATH"

第一行里的/usr/local/bin不一定只服务于 Node.js，如果还有其他工具靠这个路径运行，这行保留；只有~/.npm-global/bin这类明确和 npm 关联的路径才需要删。

如果你之前设置过 npm 全局安装路径，比如npm config set prefix "~/.npm-global"，那~/.npm-global目录也一并删除。

验证方式和 Windows 一样：新开终端窗口，执行node -v、npm -v、which node、which npm，确认都无输出。

4. 卸载后的残留检查与常用排查命令

不管你用的哪个系统，卸载完成后不要急着重装。先花两分钟做一轮全面残留检查，避免新装的环境被旧文件的“幽灵”影响。

4.1 检查项目中的配置文件

node_modules会因为各种原因没删干净，但这不影响重装。真正可能影响新环境的是全局配置文件，分布在用户目录下的点文件中。

在 Windows 上检查C:\Users\你的用户名\.npmrc，在 macOS 上检查~/.npmrc。这个文件如果存在，说明 npm 有全局配置，比如 registry 镜像源、代理、缓存路径。重装 Node.js 后这个文件可能保留旧的 registry 设置，如果你不想继续用，就手动删掉或编辑。

同理还有~/.yarnrc、~/.pnpm-store、~/.config/yarn等文件，这些都是 npm 生态相关工具留下的，卸载 Node.js 时一并清理，免得误导系统认为相关工具还可用。

4.2 全局搜索残留文件名

Windows 上可以用“文件资源管理器”搜索 node、npm、npx 关键字；macOS 上可以用mdfind命令：

mdfind -name node mdfind -name npm

这几条命令的检索结果会包含大量不属于 Node.js 的文件，比如/System下的系统资源，不需要全部清理。重点看有没有出现/usr/local、/opt/homebrew、~/开头且路径里含node_modules、npm-cache、nvm的条目。

4.3 命令残留的定位思路

卸载后执行node -v如果还有版本号输出，说明系统里还有另一个 Node.js 可执行文件被 PATH 指向。用where node（Windows）或which -a node（macOS）把所有包含 node 可执行文件的路径列出来，逐个删除。这种情况最容易发生在你以前用过 zip 解压版 Node.js、后来又装了安装版，两个版本并存，卸载只清掉了一个。

4.4 重装前的最后建议

彻底卸载干净后重装，我个人的经验是：Windows 用户优先用官方安装包（msi），macOS 用户优先用 nvm 或 fnm 装，不建议直接 pkg 安装。原因是 pkg 安装时文件分散在/usr/local多个位置，后续你想换版本或再次卸载，仍然要重复上面的手动清理过程。而 nvm、fnm 这类版本管理器把所有版本都收在用户目录下一个文件夹里，想换版本执行一条命令就能完成，体验好太多。

5. 卸载过程中的常见问题与解决办法

卸载 Node.js 的时候，最让人头疼的不是命令不会写，而是系统提示各种“删除失败”“命令不存在”的异常状态。这里集中列一下我实际遇到过的问题和对应的处理思路。

5.1 Windows 提示“操作无法完成，因为文件已在另一程序中打开”

这个提示基本可以断定是有 node 相关进程还在跑。打开任务管理器，在“进程”标签页里找“Node.js JavaScript Runtime”或名字含 node 的进程，右键结束任务。如果任务管理器找不到，试试taskkill命令：

taskkill /f /im node.exe taskkill /f /im npm.exe taskkill /f /im npx.exe

/f是强制结束，/im是按映像名称匹配进程。执行后回到资源管理器删除目录，多半就能成功了。

5.2 卸载后执行 node -v 仍然显示版本号

原因几乎都是 PATH 里还有另一个 node 路径在生效。执行where node看完整的搜索路径列表，把列出的所有目录都检查一遍。特别留意C:\Windows\System32里有没有node.exe——极少数情况下，某些第三方安装包会把 node 拷贝到这个目录，导致误判。

macOS 上用which -a node列所有路径。另外还有一种隐蔽情况：如果你配置过 alias，终端里输入 node 走的可能是 shell alias。执行type node或alias node检查一下。

5.3 注册表编辑器搜索 nodejs 出现大量无关结果

这很正常，很多软件都会在注册表里记录自己的安装信息或配置路径，包含 nodejs 字样不代表它们依赖 Node.js 运行。

修改注册表时，只处理项名明确为 Node.js、npm、node 或路径里明显包含这些关键词的项。搜索结果里出现在其他软件的描述信息中的“nodejs”，不要去动。

5.4 macOS 提示 “Operation not permitted” 或删除目录时权限不够

macOS 对系统目录有 SIP（System Integrity Protection）保护，/usr/local下的文件通常需要sudo才能删除。确保你的每条 rm 命令都加了sudo。

另一个原因可能是某些文件被隔离了，表现为“文件已损坏”或“无法修改”。提示“Operation not permitted”时可以执行xattr -cr 文件路径清除扩展属性后再删。

5.5 全局包删不干净，重装后npm ls -g还能看到旧包

全局包目录没有删透的时候最容易出现这个现象。Windows 上执行npm root -g查看全局包的真实路径，确认这个目录已经被删掉；macOS 上执行npm prefix -g查看。如果这两个命令输出的目录已经在之前的清理步骤中删除了，那重装完 npm 后是不会再看到旧包的。

还有一点容易忽略：package-lock.json、pnpm-lock.yaml这类锁文件是不受 Node.js 卸载影响的，它们属于项目本身。重装完 Node.js 后，在项目根目录执行npm ci时，npm 会按锁文件重建依赖目录，这个过程中旧包的残留会被自然覆盖。如果锁文件本身有问题，直接把node_modules删掉再npm install即可。

6. 最后说几句经验

卸载 Node.js 这件事，麻烦不麻烦，取决于你当初是怎么装的。官方安装包装上去简单，卸的时候散落在各个角落；用 nvm、fnm 这类统一管理的版本管理器装，卸的时候一个命令全带走。我现在的习惯是任何机器上都不用官方 pkg 直接装 Node.js，一律用版本管理器，就是为了避免这种“拆一颗炸弹”式的清理流程。

如果你只是为了升级版本而卸载，那我建议你看看有没有可能用nvm直接切版本，省去全套卸载流程。已经下定决心要清理的，按照上面 Windows 和 macOS 的完整流程走一遍，每一处残留都不会放过。最后再提醒一次：操作注册表、环境变量和/usr/local这类系统级目录前，截图备份原始状态，给自己留一条退路。