最近好几个朋友在升级到 Win11 之后跑来问我Node.js 到底怎么装照着网上的教程一路点击下一步装完在终端里敲node -v照样提示“不是内部或外部命令”还有人刚换了 26H2、27H2 这样的新版本系统双击安装包之后发现一点反应都没有。这篇文章我把自己在 Win11 上装 Node.js 的完整流程、踩过的坑和最后沉淀下来的配置方案整理出来覆盖下载、安装、环境变量、npm 配置到常见报错排查新手老手都能直接照着抄。如果你是一个刚开始接触前端开发的学生、准备在本地跑脚本的运营或测试、或者刚换了 Win11 电脑的开发者这篇内容应该能帮你少走很多弯路。Node.js 本质上是一个让 JavaScript 脱离浏览器运行的环境很多现代工具链比如 Vite、Next.js、Electron都依赖它先装好。装好之后不只是能跑一个console.log后面几乎所有 JavaScript 项目的本地调试都要从这一步开始。1. 安装前的准备与版本选择1.1 先想清楚你需要哪个 Node.js 版本很多人上来就直接抓最新版其实这是第一个坑。Node.js 的版本策略很明确偶数大版本通常是长期维护版LTS奇数大版本则是尝鲜版Current。比如 20.x、22.x 都是 LTS 版本23.x、24.x 属于更激进的新功能版本维护周期短功能变化快不太适合拿来跑正式项目。我自己的选择标准很简单如果是新项目、上课作业、公司业务一律用当前推荐的 LTS 版只有当你需要实验新特性或者某个第三方库明确要求新版本时才去装 Current 版。另外如果你手头有老项目打开项目的package.json看一眼 engines 字段里面可能写了项目要求的 Node 版本范围。装一个和项目要求不匹配的版本后面跑npm install会冒出一堆依赖报错。使用场景推荐版本原因新项目/学习/日常开发官网首页 LTS 推荐版稳定、生态兼容好、安全更新周期长老项目维护项目要求的旧 LTS如 18.x依赖包可能未兼容新版运行时体验新语法/新 API官网 Current 最新版能用到刚发布的功能但风险自担还有一个很容易忽略的问题不要同时在系统 PATH 里放多个 Node 版本。如果你以前装过 18现在又装 22两个安装目录同时生效终端里敲node -v输出的结果完全看 PATH 顺序排查起来非常头疼。后面第 5 章我会专门讲用工具做版本管理那才是长期开发的正解。1.2 下载渠道和安装包怎么选下载安装包这件事我建议只认两个来源Node.js 官网和国内公认的镜像站点。官网的下载地址是nodejs.org进去后首页就有很大的下载按钮不会弹出什么奇怪的杂项下载到的文件也带官方数字签名安全上有保障。安装包有三种常见格式很多人不知道区别这里直接放表格式安装方式适合谁.msi推荐双击进入图形引导自动写入 PATH绝大多数用户尤其是新手.exeNSIS图形引导安装跟 msi 类似没有 Windows Installer 服务时应急用.zip/.7z解压即用需要手动配环境变量老手、便携式开发环境、绿色软件爱好者在 Win11 上我最推荐.msi没有特殊理由就是省事。它会自动帮你处理 PATH、文件关联、Corepack 等一系列东西。.zip虽然看起来很干净但每次换项目或换目录都要手动维护环境变量对普通用户来说纯属自找麻烦。另外一个细节下载页面一般会同时提供 32 位和 64 位包现在的电脑几乎都是 64 位下载Windows 64-bit Installer就不会错。如果拿不准可以在设置里搜索“系统信息”看“系统类型”这一栏会明确告诉你 CPU 是 x64 还是 ARM64。Win11 也开始有 ARM 版设备那就需要选择 ARM64 安装包。1.3 把系统环境提前检查一遍别急着双击安装包我建议你先花 1 分钟确认一下系统状况否则后面报错会一头雾水。按Win R输入winver回车会弹出一个窗口显示当前系统版本。比如 Windows 11 专业版 22H2、23H2或者新版本的 26H2、27H2 预览版。不同 Win11 版本的安装器兼容性不太一样但总体差异不大。如果你发现系统太老比如还在很早期的 Win11 版本建议先去“设置 - Windows 更新”里把系统补丁打全再回来装 Node.js。我遇到过几个案例系统更新刚装到一半就抢着装 Node结果 MSI 安装器直接卡死。然后确认一下你当前登录的用户有没有管理员权限。MSI 安装包在写入C:\Program Files和系统环境变量时需要管理员权限普通游客账户会弹 UAC输了密码可能也没法继续。最简单的方法是右键点击安装包菜单里如果有“以管理员身份运行”选项就用它启动。还有一点如果你刚升级完 Windows或者系统里还有残留的旧版 Node.js最好先把旧版卸载干净。卸载路径在“设置 - 应用 - 已安装的应用”里搜“node”把 Node.js 相关的项都卸载再手动检查一下旧安装目录和 PATH 里是否还有残留引用。干净的系统环境能省掉后面至少一半的问题。2. 从下载到安装完成的完整步骤2.1 官网下载安装包的具体操作打开 Node.js 官网后你会看到首页有两个大按钮左边是“LTS”右边是“Current”。点击左侧 LTS 下的下载按钮会直接开始下载适用于 Windows 的.msi安装包不用去二级页面再选。如果想要更精确的控制可以点页面上方的“Download”进入下载页这里能选操作系统和架构。找到Windows Installer (.msi)这一行选择 64-bit 下载。下载完成后建议先检查一下文件大小正常的 Node.js 22.x 的 msi 包一般在 30MB 左右。如果只有几 MB 甚至几百 KB说明下载过程出问题了不要双击删掉重新下载。在浏览器里下载时Win11 自带的 Microsoft Edge 会默认下载到C:\Users\你的用户名\Downloads。为了后续查找方便我习惯在桌面上新建一个installer文件夹把安装包放进去既显眼又不会混淆。当然这个纯属个人习惯只要你能找得到就行。注意官网镜像和第三方“高速下载站”是两个概念。网上很多所谓“Node.js 中文网”“Node.js 下载站”其实是个人维护的镜像域名变化频繁分发包也不一定完整。非官方源的包安装后可能多出全家桶或者文件被篡改。除非你能确认来源可信否则只从官网拿。2.2 安装向导一步步怎么点拿到.msi安装包后右键点击选择“以管理员身份运行”。如果双击也能弹 UAC 授权那也一样但右键更稳。进入安装向导后按下面的顺序来Welcome 界面直接点 Next。License Agreement勾选“I accept the terms in the License Agreement”再点 Next。Destination Folder安装目录默认是C:\Program Files\nodejs\。这个地方我的建议是如果你只有一个 C 盘就用默认路径别乱改如果有多块硬盘可以改成其他盘的nodejs目录。路径里不要有中文不要有空格以外的特殊符号。Custom Setup这里会列出组件默认通常全部勾选。其中包含Node.js runtime、npm package manager、Corepack、Online documentation shortcuts等选项。Corepack 建议保留它是后续启用 pnpm/yarn 的官方工具在线文档快捷方式可有可无不碍事。Tools for Native Modules这一页是询问要不要自动安装编译原生模块需要的 Python、Visual Studio Build Tools。如果你只是写业务代码、跑脚本可以不勾选省很多时间和磁盘。如果你准备开发 C 插件或某些底层 npm 包那就勾上它会联网下载额外的工具链。Install点击安装等待进度条跑完。安装过程通常不超过 1 分钟。安装完成后点 Finish 按钮。此时不要急着打开终端因为当前所有已经打开的终端窗口里环境变量还是老样子读不到新安装的 Node。必须完全关掉终端重新打开一个新窗口。2.3 安装完怎么确认已经成功重新打开一个终端推荐用 Win11 自带的 Windows Terminal快捷键Win X后选“终端”输入node -v如果输出类似v22.11.0这样的版本号说明 Node 本体安装成功。接着输入npm -v看到类似10.9.0的输出说明 npm 包管理器也正常。还有一条命令建议顺手敲一下where node它会列出系统找到的 node.exe 路径。正常情况下应该只有一条指向你刚才安装的目录。如果这里出现多个路径说明你电脑里可能残留了不同位置的 Node后面运行就存在版本混乱的隐患。如果你用的是 PowerShell第一次运行node -v时可能会遇到安全策略拦截提示“无法加载文件因为在此系统上禁止运行脚本”。这在后面的章节会专门讲现行解决办法可以在终端里执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser输入Y确认即可。3. 环境变量、npm 配置与路径问题3.1 PATH 环境变量到底管什么很多教程会让你手动去配 PATH其实 msi 安装包已经做完了这件事。但多理解一下终归没坏处毕竟后面配置全局模块时还是要碰它。PATH 是 Windows 系统的一项环境变量它里面存了一堆文件夹路径。当你在终端里输入node系统就按照 PATH 里的顺序一个文件夹一个文件夹地找直到某个文件夹里存在node.exe。找到就和执行程序一样运行它全部找不到就提示“不是内部或外部命令”。在 Win11 下检查 PATH 的方法右键点击“开始”按钮选择“系统”再点右侧的“高级系统设置”弹出的窗口里选“环境变量”。在“系统变量”列表里找到Path双击编辑能看到里面有没有C:\Program Files\nodejs\这一条。大多数时候安装完发现 node 命令不可用都不是真的没写入 PATH而是终端窗口没有重开。我见过太多人装完 Node 后在当前窗口敲命令报错就跑去卸载重装结果折腾半小时最后新版终端一开一切正常。切换环境变量后Shell 不会自动刷新这是 Windows 的经典坑。3.2 设置 npm 全局目录和缓存目录npm 默认会把全局安装的包放在系统盘的用户目录下具体是C:\Users\你的用户名\AppData\Roaming\npm缓存放在C:\Users\你的用户名\AppData\Local\npm-cache。如果 C 盘空间紧张或者你不喜欢所有东西全堆在系统盘可以把这两个目录改到其他盘。先创建两个空目录比如在D:盘建立D:\nodejs\node_global D:\nodejs\node_cache然后用 npm 命令告诉它新位置npm config set prefix D:\nodejs\node_global npm config set cache D:\nodejs\node_cache设置完后为了让全局安装出来的命令比如后面要装的pnpm、nodemon在终端里可以直接运行还要把D:\nodejs\node_global加到系统 PATH 中。步骤和前面一样系统属性 → 环境变量 → 编辑Path→ 新建 → 填入目录路径 → 确定。这个配置可能有人会问改了 prefix 会不会影响 npm 装本地依赖不会。本地项目的依赖永远优先安装在项目自身的node_modules目录里prefix 只影响npm install -g的全局命令位置。全局命令本质上是把可执行脚本放到了指定目录依赖仍然放在全局目录的 node_modules 子文件夹里逻辑是自洽的。3.3 换源加速 npm 下载npm 默认的包下载源是国外的官方仓库registry.npmjs.org。国内网络环境下经常会出现下载超时、卡在idealTree半天不动、或者反复重试的情况。解决办法是把它切换到国内公共镜像源最常用的是 npmmirror原淘宝镜像。npm config set registry https://registry.npmmirror.com设置完成后验证一下npm config get registry输出https://registry.npmmirror.com/说明已经生效。镜像源是官方 registry 的同步副本包内容不会变只是下载速度更快不改变你的业务代码逻辑。如果你在一家公司里团队可能自建了私服比如 Verdaccio、Nexus这种时候可以把 registry 换成公司内网地址原理完全一样。补充一个经验别迷信“全局换源能解决一切”。有时候项目里直接引用了 GitHub 上的依赖那是走 git 协议下载的换源解决不了。碰到这种情况要么配置 git 代理要么换个网络环境这部分不是 Node 安装本身的范畴我也不展开太多。4. 常见问题与排查手记4.1 双击安装包没反应或安装中断这种现象在 Win11 上并不少见尤其是系统刚升级到较新版本之后。遇到安装包点了没反应先按顺序排查文件是否下载完整右键安装包 → 属性 → 常规 → 大小看看是否和官网标注一致。也可以右键点击文件 →“属性”→“数字签名”确认签名来源正常。Windows 安全中心拦截Win11 有“智能应用控制”或杀毒软件实时防护可能拦截未识别的安装程序。看右下角或 Windows 安全中心有没有拦截通知。确认是官网下载的文件后可以选择“仍要运行”而不是关闭整个安全软件。权限问题再次右键安装包选择“以管理员身份运行”UAC 弹窗点时。系统更新占用了安装服务如果你刚设置完 Win11 更新系统还在后台处理MSI 服务可能被锁定。重启一次电脑再装通常就没事了。如果所有方法都不行退一步用.exe安装包代替.msi兼容性在特殊系统上反而好一些。另一个冷门原因是安装了某些安全加固类软件把 Windows Installermsiexec服务停用了。按Win R输入services.msc找到Windows Installer把它启动起来再重新运行安装包。4.2 node 不是内部或外部命令这个提示几乎每个人都会遇到一次。先别急着卸载重装按这个顺序查打开新终端窗口再试一次node -v。用where node看看系统能不能找到如果能找到说明终端缓存问题重开终端即可。如果完全没有输出去安装目录手动看看node.exe是否存在。再看环境变量里有没有包含安装目录。还有一种情况安装时你选择了“仅为当前用户安装”但终端是以管理员身份开的用户级 PATH 和系统级 PATH 并不完全一样。解决方法是把 Node 安装目录同时添加到系统 PATH 中。如果以上都查了还是不行那可能旧版本卸载残留了无效的 PATH 条目。清理 PATH 里所有指向 node 的旧路径只留下一份正确的再重开终端测试。通常改完环境变量需要完全退出终端程序再重新启动而不是新开一个标签页这一点注意一下。4.3 npm 安装包时报错怎么办最常见的 npm 报错类似这样npm ERR! code ETIMEDOUT npm ERR! network request to ... failed npm ERR! ERESOLVE unable to resolve dependency treeETIMEDOUT、ECONNREFUSED、ENETUNREACH基本都是网络问题。先把 registry 切换到国内镜像然后再试一次。如果项目之前已经生成过package-lock.json直接删除锁文件和node_modules目录重新执行npm install不要试图手工改锁文件。ERESOLVE这类依赖冲突常见是因为全局 npm 版本过旧或者项目依赖之间存在 peerDependencies 冲突。可以先用npm config get registry确认源再执行npm cache clean --force清掉缓存后重装。如果依然报错看看 npm 版本是不是太老用npm install -g npmlatest升级 npm 本身。还有一个容易忽略的问题路径权限。当你把项目放在C:\Program Files下或者某些系统保护目录里npm 写node_modules会触发权限拦截。把项目路径挪到普通目录比如D:\projects\xxx这类问题基本就消失了。4.4 Win11 特有的终端与权限问题Win11 的默认终端是 Windows Terminal默认打开通常是 PowerShell。PowerShell 对脚本执行有限制有时候你会看到无法加载文件 xxx.ps1因为在此系统上禁止运行脚本。这不代表 Node 没装好只是 PowerShell 不让跑.ps1脚本。解决办法Set-ExecutionPolicy RemoteSigned -Scope CurrentUser这条命令的作用是允许本地脚本运行远程签名的脚本则必须可信。改完后当前用户可以正常执行 npm 生成的命令文件。另一个 Win11 相关的小坑是右键菜单。从 22H2 开始Win11 默认右键菜单把很多选项折叠进了“显示更多选项”很多老教程里的“打开命令提示符”“打开 PowerShell”选项位置变了。其实直接按Win X弹出的快捷菜单里就有终端或者直接在文件资源管理器地址栏输入cmd回车也能打开命令行。想改回旧版右键菜单的朋友需要额外改注册表这和 Node 安装没有关系我只提一句不乱带节奏。提示如果在 Win11 上遇到应用商店打开报错0x80004002这类系统组件问题它通常和 Node 安装无关属于系统组件损坏可以尝试在“设置 - 系统 - 系统组件”里修复或者重装系统解决。Node 安装不依赖应用商店所以不用被这类报错干扰。5. 安装完之后的实用扩展5.1 用 Hello World 验证完整链路装好 Node 后最好用一个小例子走一遍流程。新建一个文件夹比如D:\demo在里面创建hello.js内容写一行console.log(Hello Node.js on Win11);打开终端切换到该目录cd /d D:\demo node hello.js能看到Hello Node.js on Win11输出说明 Node 运行环境完全正常。再进一步可以写一个最简单的 HTTP 服务const http require(http); const server http.createServer((req, res) { res.writeHead(200, { Content-Type: text/plain; charsetutf-8 }); res.end(Hello Node.js on Win11); }); server.listen(3000, () { console.log(Server running at http://localhost:3000); });在终端执行node server.js然后浏览器打开http://localhost:3000能看到页面显示文字。这一步是验收 Node 是否正常工作的通用方式后面做 Web 项目时基本都会用上这个套路。5.2 装几个真正用得上的工具Node 装好后命令行世界里最能提升效率的几件套我的建议是pnpm新一代包管理器磁盘占用小、安装快。可以用 Corepack 启用corepack enable corepack prepare pnpmlatest --activate启用后直接pnpm -v看版本。nodemon监听文件变化自动重启 Node 服务写接口调试时特别爽npm install -g nodemonTypeScript如果不满足于写纯 JavaScript装一个 TypeScript 编译器npm install -g typescript这些工具全部通过 npm 全局安装安装位置取决于你在 3.2 节设置的 prefix。如果没改 prefix默认会装到用户目录下功能不受影响只是 C 盘会慢慢变大。5.3 版本管理和后续升级如果你准备长期做 JavaScript 开发我不建议一直用 msi 安装包来管理 Node 版本。Windows 上最好用的版本管理工具是nvm-windows它可以在同一台机器安装多个 Node 版本随时切换。使用步骤先卸载当前系统里的 Node.js清理环境变量里的 node 相关路径。到 nvm-windows 的 GitHub 仓库下载最新 release 安装包按提示安装。安装完成后打开终端执行nvm version安装指定版本的 Nodenvm install 22 nvm use 22验证node -v用 nvm-windows 有一个好处升级 Node 大版本时不再需要重新下载 readme、重复配环境变量一条命令就能切回旧版本。坏处是初次配置稍多适合有一定基础之后再用。如果只是临时需要一个新版本直接用 msi 覆盖安装旧版本也可以npm 全局包一般会保留在原来的目录但跨大版本可能出现兼容问题建议先备份package.json。最后分享一个我自己的使用习惯装完 Node 后的第一件事不是写代码而是把终端、npm 源、全局目录这三样确认好再跑一个node -v和npm -v。两个命令都正常输出后才算是把环境真正准备好了。很多人辛辛苦苦装完第二天打开电脑发现命令又找不到了十有八九是 PATH 里同时存在多个残留路径或者终端启动时加载的用户级配置出了问题。以后换新电脑我都是先装 nvm-windows 再装 LTS然后是 npm 换源整套流程十几分钟就搞定。下载 Node.js 永远从官网或可信镜像渠道拿安装包别贪方便用不明第三方链接这是我最想提醒你的一句话。