如果你搜到这篇教程那多半是 Node.js 环境已经把你折腾得够呛了。可能是npm动不动报错可能是node -v显示的版本怎么看都不对劲也可能是装了某个工具之后整个命令行都瘫了。我自己在过去几年里给不同系统重装过无数次 Node.js踩过的坑基本都长一个样卸载不彻底、残留文件作祟、环境变量混乱。这篇就把 Windows、macOS、Linux含 CentOS三条线的卸载重装全流程一次性讲清楚照着做就行。先说清楚这篇能解决什么问题第一教你如何把 Node.js 从系统里真正意义上“请出去”不留后患第二教你下载并安装对版本第三教你在安装后做一套完整验证确保新环境是干净的。适合被环境问题卡住的新手也适合需要批量给服务器装环境的运维同学。1. 什么情况必须走卸载重装这条路1.1 先判断问题出在哪很多人一遇到 Node.js 相关的报错第一反应就是“卸了重装”。但我建议你先花两分钟判断一下到底真是环境坏了还是只是某个项目自己的问题。给你几个典型信号node -v能正常输出但npm -v报错或者直接提示找不到 npm。打开新终端窗口提示node: command not found或者npm: command not found。运行前端项目时报一堆模块版本冲突但明明是昨天还能跑的项目。安装全局工具比如vue-cli、create-react-app后命令行敲命令没反应或者提示“不是内部或外部命令”。npm install时频繁出现EACCES、EPERM这类权限错误。用where node或which node查出来好几个不同路径系统加载的还不是你预期那个。如果中了两条以上那确实得走一轮卸载重装。但这里有个关键认知大多数重装失败案例不是因为安装包有问题而是因为旧的残留没清理干净。新版本装上去了运行时却找到了旧版本的路径或者被旧的环境变量搅局结果你看着像是新装实际跑的还是一堆旧碎片。1.2 卸载不干净的后果Windows 下最常见的情况是你从“控制面板—程序和功能”里把 Node.js 卸载了然后兴冲冲去官网下载了新版安装装完一打开命令行node -v出来的还是旧版本号。有些更离谱的直接提示找不到模块。这就是典型的残留问题。残留的东西通常分三类主程序目录、全局缓存目录、环境变量。主程序目录没删干净的话卸载过程可能留下部分文件导致新安装时文件冲突缓存目录没清理的话旧版本的全局包、缓存包全堆在那里新版本一启动就去扫这些旧数据环境变量没清干净就更麻烦PATH 列表里留着好几个 node 路径系统按顺序找命令时可能找到的就不是你刚装好的那个。macOS 和 Linux 上也有类似的痛点特别是用sudo安装过的人权限问题会一路纠缠到重装之后。基于这些情况我一般建议如果能用版本管理工具解决的就别走系统级卸载重装如果已经走到这一步就务必把清理做彻底。1.3 动手前先备份清理之前还有一步很重要的操作——备份你的全局配置和项目清单。因为卸载不光是掉一个运行环境还会把你辛苦装好的全局包一起干掉。你至少需要记录两样东西全局安装过哪些包执行npm list -g --depth0把输出保存下来。npm 配置文件内容查看npm config list把 registry 地址、prefix 路径这些记下来。为什么要备份因为重装之后你会发现全局包一个都不剩了。如果手头没有清单就只能凭记忆一个一个装回去。这是很多人忽略的细节但实际重装时能帮你节省大量时间。2. Windows 系统彻底卸载的完整操作2.1 第一步通过控制面板卸载主程序Windows 下最标准的卸载方式是走“控制面板”而不是直接删除文件夹。操作路径按Win R打开运行对话框输入appwiz.cpl回车打开“程序和功能”。找到 Node.js右键选择“卸载”。如果你用的是 Windows 10/11也可以去“设置—应用—已安装的应用”里找。重点来了控制面板卸载只会移除主程序本体但不会清理你的 npm 全局目录和缓存目录。所以这块做完之后千万别急着装新版。如果你机器上装的是 nvm-windows 管理的 Node那不需要走控制面板直接在 nvm 里nvm uninstall 版本号就行。但如果你已经搞不清楚当初是怎么装的就按控制面板路径走。2.2 第二步手工清理残留目录这一步是整个 Windows 卸载流程里最关键的一环做不干净后面全是坑。打开文件资源管理器手动删除下面几个目录如果没有就不管它C:\Program Files\nodejs——主程序目录正常卸载后可能残留空壳或部分文件。C:\Users\你的用户名\AppData\Roaming\npm——全局包安装目录。C:\Users\你的用户名\AppData\Roaming\npm-cache——npm 缓存目录。C:\Users\你的用户名\AppData\Local\Temp下的 npm 临时文件有就删没有跳过。有一个很好用的检查方式打开 PowerShell执行Get-ChildItem -Path C:\Users\$env:USERNAME\AppData\Roaming, C:\Users\$env:USERNAME\AppData\Local -Filter *npm* -Directory看看还能搜到哪些 node 或 npm 相关的目录。找到的直接在资源管理器里删除。这里补充一个我个人的癖好删完后我习惯用 Everything一个文件搜索工具全盘搜一遍node_modules这种大目录确认没有明显残留。全局 node_modules 是装在AppData\Roaming\npm里的而每个项目自带的是node_modules后者不归这次清理管——你没必要删项目里的依赖。2.3 第三步环境变量清理环境变量清不好可能出现一种很诡异的现场你删了 Node.js但node -v居然还能输出版本。这大概率是系统里还有备份副本或者 PATH 指向了某个你已经不记得的目录。按Win R输入sysdm.cpl切到“高级”选项卡点“环境变量”然后分别检查两条 PATH用户变量里的 PATH系统变量里的 PATH把包含nodejs的所有条目删除。顺手检查一下有没有单独的NODE_PATH这种自定义变量有就一并删掉。这里不要手软因为你马上要装新版本旧路径留着不但没用还会干扰新版本的命令查找优先级。环境变量这块给我印象最深的坑是很多软件安装时会在 PATH 里插入自己的目录但卸载时并不会帮你移除。所以哪怕你重装了好几遍PATH 里可能还堆着几年前的旧路径。删完之后重新打开一个新的命令行窗口再确认一遍。注意是“新的”窗口已经打开的窗口不会刷新环境变量。2.4 验证干净程度系统级清理的最后一步是确认真的干净了。打开新的命令行窗口执行以下命令where node where npm正常结果应该是“找不到指定的文件”之类的提示。如果你还能看到路径输出说明还有残留回头查查是不是 PATH 里还有漏网之鱼或者某些目录你刚才没删干净。再执行echo %PATH%确认输出里没有 nodejs 相关目录。这里有个容易被忽略的点命令提示符的 PATH 和 PowerShell 的 PATH 可能显示不同因为两者的生效逻辑有差异。所以你在 CMD 里验证完再用 PowerShell 验证一次两边都干净才算完。3. macOS 系统卸载流程3.1 通过 Homebrew 安装的卸载macOS 用户凡是吐槽 node 环境乱的八成是用 Homebrew 装的。清理思路和 Windows 大同小异只是路径不同。先停掉可能占用 node 进程的服务然后执行卸载命令brew uninstall --ignore-dependencies node加--ignore-dependencies是因为有些包依赖 node不加的话 brew 会拦住你。卸载完检查一下有哪些孤立残留ls -la /usr/local/lib/node_modules ls -la /usr/local/include/node有就手动删掉。还要清理全局安装的 npm 包rm -rf /usr/local/lib/node_modules rm -rf ~/.npm~/.npm是 npm 的本地缓存目录可能占不少空间删掉一了百了。如果你之前是用官方 pkg 安装包装的不是 brew那卸载方式不太一样。官方安装包虽然也有卸载功能但经常卸载不干净。需要手工删的目录包括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 ~/.npm这里面/usr/local/bin/npm和npx经常被漏掉因为它们是软链接或者脚本文件不太起眼但确实是残留重灾区。3.2 手工安装的卸载如果你当初是从 nodejs.org 下载 pkg 双击安装的卸载时除了删二进制还得清理几个隐藏文件。在终端执行sudo rm -rf /usr/local/bin/corepack 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 ~/.npm sudo rm -rf ~/.nvm~/.nvm是 nvm 的默认安装目录如果你确定不用 nvm 了就一起删。不确定就先留着别误伤。3.3 清理 shell 配置文件macOS 用户很多会在~/.zshrc或~/.bash_profile里添加过 node 相关的 PATH 配置。清理完文件后一定要打开这些配置文件看一眼把里面跟 node、npm 相关的行删掉。具体来说打开终端执行cat ~/.zshrc如果看到export PATH/usr/local/bin/node:...这种或者 nvm 相关的初始化脚本而你确定不打算再用 nvm 了就编辑删掉。别忘了改完之后执行source ~/.zshrc让配置重新加载。这里多说一句macOS 上很多人装 node 时装过 nvmnvm 有自己的一套目录结构平时不显山不露水但卸载 node 时它还能继续接管版本管理。如果你是因为 nvm 和系统 node 冲突才来重装那建议把 nvm 相关配置也一并理清不然后面装新版照样会被劫持。4. Linux/CentOS 卸载流程4.1 区分安装方式Linux 这边卸 Node 最难的地方在于你得先搞清楚当初是怎么装的。不同安装方式留下的尸体位置完全不同yum install nodejs或apt-get install nodejs——包管理器安装。curl官网 tarball 解压——手动安装通常放在/usr/local或某个自定义目录。nvm 安装——家目录下的~/.nvm。判断方法很简单在终端执行which node rpm -qf /usr/local/bin/node 2/dev/null如果第二条命令输出了安装包名称说明当初是用 yum/rpm 装的走包管理器卸载最干净如果提示“file not owned by any package”说明是手动解压安装得自己清理目录。4.2 卸载与残留清理CentOS 7.9 上用 yum 装的卸载命令是sudo yum remove nodejs npmUbuntu/Debian 上则是sudo apt-get remove --purge nodejs npm但这里有个大坑yum 卸载同样不会清理/usr/local/lib/node_modules、~/.npm和你项目里缓存的东西。所以包管理器卸完之后还要手动扫一遍sudo rm -rf /usr/local/lib/node_modules sudo rm -rf ~/.npm sudo rm -rf ~/.node sudo rm -rf /usr/local/include/node sudo rm -rf /usr/local/bin/node sudo rm -rf /usr/local/bin/npm sudo rm -rf /usr/local/bin/npx如果你是用 nvm 装的那十有八九不用走上面那套系统级删除直接在 nvm 里删就行nvm uninstall 版本号想彻底把 nvm 也卸掉就删~/.nvm目录并把 shell 配置里的 nvm 初始化脚本去掉。4.3 CentOS 7.9 在线安装示例CentOS 7.9 自带软件源里的 Node 版本偏旧而且 yum 源里默认没有 Node.js 包。所以很多人在服务器上装 Node 走的是 Nodesource 脚本方式。手动安装的方式是curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash - sudo yum install -y nodejs安装完建议做一轮验证确认版本和你预期的一致。CentOS 7 上还容易遇到一个经典问题glibc 版本太老新版 Node 跑不起来。Node 18 版本对 glibc 2.27 以上有要求CentOS 7.9 默认 glibc 是 2.17所以你需要确认自己下载的 Node 版本是否兼容。遇到这个问题最简单的处理是选低一档的版本比如 Node 16 系列。5. 重新安装与版本选择5.1 LTS 还是 Current卸载干净之后接下来面对的问题就是装哪个版本。官网下载页有两个大按钮LTS 和 Current。很多新手直接点 Current后面就悲剧了。LTS 是长期维护版生产环境首选适合绝大多数做开发的人。Current 是最新特性版适合想尝鲜、对上游依赖要求比较新的场景。以 2025 年这个时间点来看Node 22 已经进入 LTS 阶段是大家默认会选的主力版本Node 18 属于以前的主力正在走向维护末期。具体选哪个看你的项目场景如果你只是跑跑工具、写写脚本装 LTS 就完事了如果你在参与某个 React/Vue 项目看清楚项目里 engines 字段要求多少版本再定安装目标。这里有个判断依据大多数前端工程的依赖都能跑在 Node 18 上但某些老项目用 Node 20/22 反而会报错。所以装之前先看一眼项目的 package.json或者 README 里的环境要求。实在拿不准就装 LTS。5.2 下载与安装这个环节其实是全篇最没技术含量的但因为它简单反而容易出问题。Windows 用户直接去 nodejs.org 点 LTS 按钮下载 msi 安装包双击一路下一步就行。重点说两个细节第一安装路径不要带中文或空格。我见过有人装在C:\Program Files\nodejs系统默认路径没问题但也有人为了“清理”方便装在D:\软件\node结果建项目时各种诡异报错。如果你没有特殊理由就用默认路径。第二安装向导里有一个选项叫“Add to PATH”默认是勾选的千万别取消。有人为了所谓的“纯净安装”把这个取消掉装完发现命令行里敲 node 没反应。macOS 用户下载 pkg 双击安装同样一路默认。Linux 用户把 Node 下载包最后的.tar.xz文件下载下来解压然后把 node 和 npm 的文件放到/usr/local/bin下面或者直接通过包管理器安装。5.3 npm 镜像配置装完 node顺手要把 npm 源切到国内镜像源。不切的话你npm install那些包的时候会体验到什么叫“等待三分钟、下载三百个依赖”。执行npm config set registry https://registry.npmmirror.com这里要说一下镜像站不是只把下载入口换了那么简单它还做了完整同步你看得到的包、版本号基本和官方源一致。但有个小问题镜像源的同步有时间延迟刚发布的包可能搜索不到。所以如果你要装一个刚发布不到半天的新包可以临时用官方源npm --registryhttps://registry.npmjs.org install xxx另外一个很实用的配置是设置 electron 之类的二进制镜像但那个属于项目级配置这里不展开了。6. 重装后的验证清单6.1 版本确认安装完成后很多人执行node -v看到版本号就觉得自己赢了。但版本号正确并不等于环境完全正常你还需要做几项验证确保“能跑起来”。打开命令行工具依次执行node -v npm -v npx -v三条命令都有正常的版本输出这才是第一步。注意观察 npm 的版本号因为 npm 是随 Node 发布的版本号和 Node 版本是配套的。如果你装了 Node 20 却发现 npm 还是老版本反而说明安装文件有问题。6.2 全局路径检查接下来检查全局安装目录是否配置正常。执行npm config get prefixWindows 下通常输出C:\Users\用户名\AppData\Roaming\npmmacOS/Linux 下通常输出/usr/local。这个路径决定了你以后npm i -g安装的工具会放在哪、命令行能不能直接调用。顺手测试一下全局包的可用性装个小工具再执行一遍命令npm i -g cowsay cowsay hellocowsay 会输出一头牛说的话看到正常输出说明全局路径权限没问题。这是我最常用来测试环境的一招比看任何配置都管用。测试完可以卸载掉npm uninstall -g cowsay之所以要跑这个测试是因为很多人的环境能在node -v上通过但一装全局工具就崩。问题往往出在全局目录的写权限上Windows 用户表现在 PATH 没生效macOS/Linux 用户表现在权限不够只能 sudo 安装。6.3 写个简单测试最后我建议你新建一个空白目录手动跑一个最小的 Node 脚本确认核心功能正常。mkdir test-node cd test-node npm init -y echo console.log(hello node) index.js node index.js输出hello node就说明基础功能没问题。再跑一次npm install试一下网络连接是否通畅npm i lodash正常情况下 npm 会自动创建node_modules目录并输出日志。如果这一步报错问题大概率出在 registry 配置或网络环境上跟 Node 本体无关。7. 常见问题与排查7.1 问题速查表重装完之后你可能会遇到一些新的或者看起来很眼熟的问题。我整理了一份速查表症状可能原因解决方向新终端里 node 不是内部或外部命令PATH 未生效或配置错误重新打开新窗口检查 PATH 是否包含 node 目录node -v正常但npm -v报错npm 文件损坏或版本不配套重新安装 Node 或重装 npm全局包装了但命令找不到全局路径不在 PATH 中检查npm config get prefix添加到 PATHnpm install网络超时registry 被卡或代理配置异常切换镜像源或检查代理环境变量EACCES权限错误全局目录无写权限重置全局目录权限或用版本管理器重装装完版本号还是旧的旧残留覆盖了新版本回到前面章节把所有残留目录清干净找不到模块node_modules项目依赖未安装重新执行npm install7.2 权限相关的坑macOS 和 Linux 用户最容易踩的权限坑就是装全局包时提示npm ERR! Error: EACCES: permission denied这通常是因为系统 node 安装在/usr/local普通用户没有写权限。很多教程会让你直接sudo npm i -g xxx但这不是长久之计因为你总不能每次都 sudo。我推荐的做法是不要用系统级安装改用 nvm 管理 Node。nvm 会把所有版本装在你的用户目录下全局包的安装路径也跟着变成用户目录权限问题从根源上消失。如果你实在不想用 nvm那就手动改一下 npm 的全局路径mkdir -p ~/.npm-global npm config set prefix ~/.npm-global echo export PATH~/.npm-global/bin:$PATH ~/.bashrc source ~/.bashrc但说句实在话现在新项目、新工具对 Node 版本的要求差别很大不同项目可能需要切换版本用 nvm 的收益远大于成本。这算是我重装过无数次之后最想给你们的建议。7.3 换源后证书错误换到国内镜像源之后有一种报错比较典型npm ERR! code CERT_HAS_EXPIRED npm ERR! errno CERT_HAS_EXPIRED遇到这个先别慌大概率是证书问题不是 npm 本体坏了。解决办法是先把源换回官方源npm config set registry https://registry.npmjs.org然后重新设置镜像源。如果还报错检查一下是否是内网代理或 SSL 配置导致的。设置strict-ssl为 false 能绕过但这是下策不建议长期用。npm config set strict-ssl false这行命令关闭 SSL 验证只适合临时排查问题正常使用还是保持默认。踩过几次坑之后我现在给任何机器重装 Node都会遵循一套固定的流程先清理干净再装合适版本然后配好镜像最后跑一遍验证清单。整个过程虽然看起来琐碎但每一步都是必要的。如果你只做“卸载—安装”这两步那大概率会在两三天后再次遇到同样的问题。最后再说一句如果你不想以后再经历这一遭装好之后尽快把版本管理工具用起来比系统级安装省心得多。
Node.js彻底卸载重装指南：覆盖Windows、macOS与Linux
如果你搜到这篇教程那多半是 Node.js 环境已经把你折腾得够呛了。可能是npm动不动报错可能是node -v显示的版本怎么看都不对劲也可能是装了某个工具之后整个命令行都瘫了。我自己在过去几年里给不同系统重装过无数次 Node.js踩过的坑基本都长一个样卸载不彻底、残留文件作祟、环境变量混乱。这篇就把 Windows、macOS、Linux含 CentOS三条线的卸载重装全流程一次性讲清楚照着做就行。先说清楚这篇能解决什么问题第一教你如何把 Node.js 从系统里真正意义上“请出去”不留后患第二教你下载并安装对版本第三教你在安装后做一套完整验证确保新环境是干净的。适合被环境问题卡住的新手也适合需要批量给服务器装环境的运维同学。1. 什么情况必须走卸载重装这条路1.1 先判断问题出在哪很多人一遇到 Node.js 相关的报错第一反应就是“卸了重装”。但我建议你先花两分钟判断一下到底真是环境坏了还是只是某个项目自己的问题。给你几个典型信号node -v能正常输出但npm -v报错或者直接提示找不到 npm。打开新终端窗口提示node: command not found或者npm: command not found。运行前端项目时报一堆模块版本冲突但明明是昨天还能跑的项目。安装全局工具比如vue-cli、create-react-app后命令行敲命令没反应或者提示“不是内部或外部命令”。npm install时频繁出现EACCES、EPERM这类权限错误。用where node或which node查出来好几个不同路径系统加载的还不是你预期那个。如果中了两条以上那确实得走一轮卸载重装。但这里有个关键认知大多数重装失败案例不是因为安装包有问题而是因为旧的残留没清理干净。新版本装上去了运行时却找到了旧版本的路径或者被旧的环境变量搅局结果你看着像是新装实际跑的还是一堆旧碎片。1.2 卸载不干净的后果Windows 下最常见的情况是你从“控制面板—程序和功能”里把 Node.js 卸载了然后兴冲冲去官网下载了新版安装装完一打开命令行node -v出来的还是旧版本号。有些更离谱的直接提示找不到模块。这就是典型的残留问题。残留的东西通常分三类主程序目录、全局缓存目录、环境变量。主程序目录没删干净的话卸载过程可能留下部分文件导致新安装时文件冲突缓存目录没清理的话旧版本的全局包、缓存包全堆在那里新版本一启动就去扫这些旧数据环境变量没清干净就更麻烦PATH 列表里留着好几个 node 路径系统按顺序找命令时可能找到的就不是你刚装好的那个。macOS 和 Linux 上也有类似的痛点特别是用sudo安装过的人权限问题会一路纠缠到重装之后。基于这些情况我一般建议如果能用版本管理工具解决的就别走系统级卸载重装如果已经走到这一步就务必把清理做彻底。1.3 动手前先备份清理之前还有一步很重要的操作——备份你的全局配置和项目清单。因为卸载不光是掉一个运行环境还会把你辛苦装好的全局包一起干掉。你至少需要记录两样东西全局安装过哪些包执行npm list -g --depth0把输出保存下来。npm 配置文件内容查看npm config list把 registry 地址、prefix 路径这些记下来。为什么要备份因为重装之后你会发现全局包一个都不剩了。如果手头没有清单就只能凭记忆一个一个装回去。这是很多人忽略的细节但实际重装时能帮你节省大量时间。2. Windows 系统彻底卸载的完整操作2.1 第一步通过控制面板卸载主程序Windows 下最标准的卸载方式是走“控制面板”而不是直接删除文件夹。操作路径按Win R打开运行对话框输入appwiz.cpl回车打开“程序和功能”。找到 Node.js右键选择“卸载”。如果你用的是 Windows 10/11也可以去“设置—应用—已安装的应用”里找。重点来了控制面板卸载只会移除主程序本体但不会清理你的 npm 全局目录和缓存目录。所以这块做完之后千万别急着装新版。如果你机器上装的是 nvm-windows 管理的 Node那不需要走控制面板直接在 nvm 里nvm uninstall 版本号就行。但如果你已经搞不清楚当初是怎么装的就按控制面板路径走。2.2 第二步手工清理残留目录这一步是整个 Windows 卸载流程里最关键的一环做不干净后面全是坑。打开文件资源管理器手动删除下面几个目录如果没有就不管它C:\Program Files\nodejs——主程序目录正常卸载后可能残留空壳或部分文件。C:\Users\你的用户名\AppData\Roaming\npm——全局包安装目录。C:\Users\你的用户名\AppData\Roaming\npm-cache——npm 缓存目录。C:\Users\你的用户名\AppData\Local\Temp下的 npm 临时文件有就删没有跳过。有一个很好用的检查方式打开 PowerShell执行Get-ChildItem -Path C:\Users\$env:USERNAME\AppData\Roaming, C:\Users\$env:USERNAME\AppData\Local -Filter *npm* -Directory看看还能搜到哪些 node 或 npm 相关的目录。找到的直接在资源管理器里删除。这里补充一个我个人的癖好删完后我习惯用 Everything一个文件搜索工具全盘搜一遍node_modules这种大目录确认没有明显残留。全局 node_modules 是装在AppData\Roaming\npm里的而每个项目自带的是node_modules后者不归这次清理管——你没必要删项目里的依赖。2.3 第三步环境变量清理环境变量清不好可能出现一种很诡异的现场你删了 Node.js但node -v居然还能输出版本。这大概率是系统里还有备份副本或者 PATH 指向了某个你已经不记得的目录。按Win R输入sysdm.cpl切到“高级”选项卡点“环境变量”然后分别检查两条 PATH用户变量里的 PATH系统变量里的 PATH把包含nodejs的所有条目删除。顺手检查一下有没有单独的NODE_PATH这种自定义变量有就一并删掉。这里不要手软因为你马上要装新版本旧路径留着不但没用还会干扰新版本的命令查找优先级。环境变量这块给我印象最深的坑是很多软件安装时会在 PATH 里插入自己的目录但卸载时并不会帮你移除。所以哪怕你重装了好几遍PATH 里可能还堆着几年前的旧路径。删完之后重新打开一个新的命令行窗口再确认一遍。注意是“新的”窗口已经打开的窗口不会刷新环境变量。2.4 验证干净程度系统级清理的最后一步是确认真的干净了。打开新的命令行窗口执行以下命令where node where npm正常结果应该是“找不到指定的文件”之类的提示。如果你还能看到路径输出说明还有残留回头查查是不是 PATH 里还有漏网之鱼或者某些目录你刚才没删干净。再执行echo %PATH%确认输出里没有 nodejs 相关目录。这里有个容易被忽略的点命令提示符的 PATH 和 PowerShell 的 PATH 可能显示不同因为两者的生效逻辑有差异。所以你在 CMD 里验证完再用 PowerShell 验证一次两边都干净才算完。3. macOS 系统卸载流程3.1 通过 Homebrew 安装的卸载macOS 用户凡是吐槽 node 环境乱的八成是用 Homebrew 装的。清理思路和 Windows 大同小异只是路径不同。先停掉可能占用 node 进程的服务然后执行卸载命令brew uninstall --ignore-dependencies node加--ignore-dependencies是因为有些包依赖 node不加的话 brew 会拦住你。卸载完检查一下有哪些孤立残留ls -la /usr/local/lib/node_modules ls -la /usr/local/include/node有就手动删掉。还要清理全局安装的 npm 包rm -rf /usr/local/lib/node_modules rm -rf ~/.npm~/.npm是 npm 的本地缓存目录可能占不少空间删掉一了百了。如果你之前是用官方 pkg 安装包装的不是 brew那卸载方式不太一样。官方安装包虽然也有卸载功能但经常卸载不干净。需要手工删的目录包括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 ~/.npm这里面/usr/local/bin/npm和npx经常被漏掉因为它们是软链接或者脚本文件不太起眼但确实是残留重灾区。3.2 手工安装的卸载如果你当初是从 nodejs.org 下载 pkg 双击安装的卸载时除了删二进制还得清理几个隐藏文件。在终端执行sudo rm -rf /usr/local/bin/corepack 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 ~/.npm sudo rm -rf ~/.nvm~/.nvm是 nvm 的默认安装目录如果你确定不用 nvm 了就一起删。不确定就先留着别误伤。3.3 清理 shell 配置文件macOS 用户很多会在~/.zshrc或~/.bash_profile里添加过 node 相关的 PATH 配置。清理完文件后一定要打开这些配置文件看一眼把里面跟 node、npm 相关的行删掉。具体来说打开终端执行cat ~/.zshrc如果看到export PATH/usr/local/bin/node:...这种或者 nvm 相关的初始化脚本而你确定不打算再用 nvm 了就编辑删掉。别忘了改完之后执行source ~/.zshrc让配置重新加载。这里多说一句macOS 上很多人装 node 时装过 nvmnvm 有自己的一套目录结构平时不显山不露水但卸载 node 时它还能继续接管版本管理。如果你是因为 nvm 和系统 node 冲突才来重装那建议把 nvm 相关配置也一并理清不然后面装新版照样会被劫持。4. Linux/CentOS 卸载流程4.1 区分安装方式Linux 这边卸 Node 最难的地方在于你得先搞清楚当初是怎么装的。不同安装方式留下的尸体位置完全不同yum install nodejs或apt-get install nodejs——包管理器安装。curl官网 tarball 解压——手动安装通常放在/usr/local或某个自定义目录。nvm 安装——家目录下的~/.nvm。判断方法很简单在终端执行which node rpm -qf /usr/local/bin/node 2/dev/null如果第二条命令输出了安装包名称说明当初是用 yum/rpm 装的走包管理器卸载最干净如果提示“file not owned by any package”说明是手动解压安装得自己清理目录。4.2 卸载与残留清理CentOS 7.9 上用 yum 装的卸载命令是sudo yum remove nodejs npmUbuntu/Debian 上则是sudo apt-get remove --purge nodejs npm但这里有个大坑yum 卸载同样不会清理/usr/local/lib/node_modules、~/.npm和你项目里缓存的东西。所以包管理器卸完之后还要手动扫一遍sudo rm -rf /usr/local/lib/node_modules sudo rm -rf ~/.npm sudo rm -rf ~/.node sudo rm -rf /usr/local/include/node sudo rm -rf /usr/local/bin/node sudo rm -rf /usr/local/bin/npm sudo rm -rf /usr/local/bin/npx如果你是用 nvm 装的那十有八九不用走上面那套系统级删除直接在 nvm 里删就行nvm uninstall 版本号想彻底把 nvm 也卸掉就删~/.nvm目录并把 shell 配置里的 nvm 初始化脚本去掉。4.3 CentOS 7.9 在线安装示例CentOS 7.9 自带软件源里的 Node 版本偏旧而且 yum 源里默认没有 Node.js 包。所以很多人在服务器上装 Node 走的是 Nodesource 脚本方式。手动安装的方式是curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash - sudo yum install -y nodejs安装完建议做一轮验证确认版本和你预期的一致。CentOS 7 上还容易遇到一个经典问题glibc 版本太老新版 Node 跑不起来。Node 18 版本对 glibc 2.27 以上有要求CentOS 7.9 默认 glibc 是 2.17所以你需要确认自己下载的 Node 版本是否兼容。遇到这个问题最简单的处理是选低一档的版本比如 Node 16 系列。5. 重新安装与版本选择5.1 LTS 还是 Current卸载干净之后接下来面对的问题就是装哪个版本。官网下载页有两个大按钮LTS 和 Current。很多新手直接点 Current后面就悲剧了。LTS 是长期维护版生产环境首选适合绝大多数做开发的人。Current 是最新特性版适合想尝鲜、对上游依赖要求比较新的场景。以 2025 年这个时间点来看Node 22 已经进入 LTS 阶段是大家默认会选的主力版本Node 18 属于以前的主力正在走向维护末期。具体选哪个看你的项目场景如果你只是跑跑工具、写写脚本装 LTS 就完事了如果你在参与某个 React/Vue 项目看清楚项目里 engines 字段要求多少版本再定安装目标。这里有个判断依据大多数前端工程的依赖都能跑在 Node 18 上但某些老项目用 Node 20/22 反而会报错。所以装之前先看一眼项目的 package.json或者 README 里的环境要求。实在拿不准就装 LTS。5.2 下载与安装这个环节其实是全篇最没技术含量的但因为它简单反而容易出问题。Windows 用户直接去 nodejs.org 点 LTS 按钮下载 msi 安装包双击一路下一步就行。重点说两个细节第一安装路径不要带中文或空格。我见过有人装在C:\Program Files\nodejs系统默认路径没问题但也有人为了“清理”方便装在D:\软件\node结果建项目时各种诡异报错。如果你没有特殊理由就用默认路径。第二安装向导里有一个选项叫“Add to PATH”默认是勾选的千万别取消。有人为了所谓的“纯净安装”把这个取消掉装完发现命令行里敲 node 没反应。macOS 用户下载 pkg 双击安装同样一路默认。Linux 用户把 Node 下载包最后的.tar.xz文件下载下来解压然后把 node 和 npm 的文件放到/usr/local/bin下面或者直接通过包管理器安装。5.3 npm 镜像配置装完 node顺手要把 npm 源切到国内镜像源。不切的话你npm install那些包的时候会体验到什么叫“等待三分钟、下载三百个依赖”。执行npm config set registry https://registry.npmmirror.com这里要说一下镜像站不是只把下载入口换了那么简单它还做了完整同步你看得到的包、版本号基本和官方源一致。但有个小问题镜像源的同步有时间延迟刚发布的包可能搜索不到。所以如果你要装一个刚发布不到半天的新包可以临时用官方源npm --registryhttps://registry.npmjs.org install xxx另外一个很实用的配置是设置 electron 之类的二进制镜像但那个属于项目级配置这里不展开了。6. 重装后的验证清单6.1 版本确认安装完成后很多人执行node -v看到版本号就觉得自己赢了。但版本号正确并不等于环境完全正常你还需要做几项验证确保“能跑起来”。打开命令行工具依次执行node -v npm -v npx -v三条命令都有正常的版本输出这才是第一步。注意观察 npm 的版本号因为 npm 是随 Node 发布的版本号和 Node 版本是配套的。如果你装了 Node 20 却发现 npm 还是老版本反而说明安装文件有问题。6.2 全局路径检查接下来检查全局安装目录是否配置正常。执行npm config get prefixWindows 下通常输出C:\Users\用户名\AppData\Roaming\npmmacOS/Linux 下通常输出/usr/local。这个路径决定了你以后npm i -g安装的工具会放在哪、命令行能不能直接调用。顺手测试一下全局包的可用性装个小工具再执行一遍命令npm i -g cowsay cowsay hellocowsay 会输出一头牛说的话看到正常输出说明全局路径权限没问题。这是我最常用来测试环境的一招比看任何配置都管用。测试完可以卸载掉npm uninstall -g cowsay之所以要跑这个测试是因为很多人的环境能在node -v上通过但一装全局工具就崩。问题往往出在全局目录的写权限上Windows 用户表现在 PATH 没生效macOS/Linux 用户表现在权限不够只能 sudo 安装。6.3 写个简单测试最后我建议你新建一个空白目录手动跑一个最小的 Node 脚本确认核心功能正常。mkdir test-node cd test-node npm init -y echo console.log(hello node) index.js node index.js输出hello node就说明基础功能没问题。再跑一次npm install试一下网络连接是否通畅npm i lodash正常情况下 npm 会自动创建node_modules目录并输出日志。如果这一步报错问题大概率出在 registry 配置或网络环境上跟 Node 本体无关。7. 常见问题与排查7.1 问题速查表重装完之后你可能会遇到一些新的或者看起来很眼熟的问题。我整理了一份速查表症状可能原因解决方向新终端里 node 不是内部或外部命令PATH 未生效或配置错误重新打开新窗口检查 PATH 是否包含 node 目录node -v正常但npm -v报错npm 文件损坏或版本不配套重新安装 Node 或重装 npm全局包装了但命令找不到全局路径不在 PATH 中检查npm config get prefix添加到 PATHnpm install网络超时registry 被卡或代理配置异常切换镜像源或检查代理环境变量EACCES权限错误全局目录无写权限重置全局目录权限或用版本管理器重装装完版本号还是旧的旧残留覆盖了新版本回到前面章节把所有残留目录清干净找不到模块node_modules项目依赖未安装重新执行npm install7.2 权限相关的坑macOS 和 Linux 用户最容易踩的权限坑就是装全局包时提示npm ERR! Error: EACCES: permission denied这通常是因为系统 node 安装在/usr/local普通用户没有写权限。很多教程会让你直接sudo npm i -g xxx但这不是长久之计因为你总不能每次都 sudo。我推荐的做法是不要用系统级安装改用 nvm 管理 Node。nvm 会把所有版本装在你的用户目录下全局包的安装路径也跟着变成用户目录权限问题从根源上消失。如果你实在不想用 nvm那就手动改一下 npm 的全局路径mkdir -p ~/.npm-global npm config set prefix ~/.npm-global echo export PATH~/.npm-global/bin:$PATH ~/.bashrc source ~/.bashrc但说句实在话现在新项目、新工具对 Node 版本的要求差别很大不同项目可能需要切换版本用 nvm 的收益远大于成本。这算是我重装过无数次之后最想给你们的建议。7.3 换源后证书错误换到国内镜像源之后有一种报错比较典型npm ERR! code CERT_HAS_EXPIRED npm ERR! errno CERT_HAS_EXPIRED遇到这个先别慌大概率是证书问题不是 npm 本体坏了。解决办法是先把源换回官方源npm config set registry https://registry.npmjs.org然后重新设置镜像源。如果还报错检查一下是否是内网代理或 SSL 配置导致的。设置strict-ssl为 false 能绕过但这是下策不建议长期用。npm config set strict-ssl false这行命令关闭 SSL 验证只适合临时排查问题正常使用还是保持默认。踩过几次坑之后我现在给任何机器重装 Node都会遵循一套固定的流程先清理干净再装合适版本然后配好镜像最后跑一遍验证清单。整个过程虽然看起来琐碎但每一步都是必要的。如果你只做“卸载—安装”这两步那大概率会在两三天后再次遇到同样的问题。最后再说一句如果你不想以后再经历这一遭装好之后尽快把版本管理工具用起来比系统级安装省心得多。
