Windows 下 Node.js 安装与配置完全指南

前言Node.js 几乎是现代前端和后端开发绕不开的运行时环境。但很多新手在安装配置时容易踩坑——比如装完了命令行里却找不到node、全局模块装完不知道去哪了、npm 下载慢得像蜗牛等等。本文将带你从零开始完成 Node.js 在 Windows 上的安装、环境配置、镜像加速以及常见问题的排查与解决。一、什么是 Node.js简单说Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行时让你能在浏览器之外跑 JS 代码。装好 Node.js 之后你会同时获得两个命令行工具node— 运行 JavaScript 的运行时npm— Node 包管理器用来安装第三方库二、下载安装包版本选择去 Node.js 官网 会看到两个版本版本说明推荐LTS长期支持版偶数大版本稳定可靠新手推荐Current最新版奇数大版本功能最新但可能有坑尝鲜用截至 2026 年 6 月推荐下载v22.x LTS。国内镜像加速下载官网下载在国内有时候很慢可以用国内镜像阿里云镜像CNPM Binaries Mirror腾讯云镜像Index of /nodejs-release/华为云镜像Index of nodejs-local选对应的大版本号如v22.20.0/下载node-v22.20.0-x64.msi或node-v22.20.0-x64.zip。推荐下.msi安装包图形化界面一路点就行。三、安装步骤3.1 运行安装程序双击下载好的.msi文件进入安装向导。3.2 接受许可协议勾选 I accept the terms in the License Agreement点 Next。3.3 选择安装路径重点不要用默认的 C 盘路径。默认路径是C:\Program Files\nodejs\建议改到其他盘比如D:\NodeJs\Node这样做的好处重装系统不怕丢、路径好记、方便排查问题。3.4 选择安装组件这里一般保持默认就行所有组件都选中。特别注意npm package manager— 必装Add to PATH— 必选否则装完系统找不到 node 命令3.5 自动安装工具可选安装到最后一步会弹出一个复选框问你要不要自动安装 Chocolatey 等额外工具。勾掉不需要。直接点 Finish 完成安装。四、验证安装打开一个新的 PowerShell 或 CMD 窗口依次输入node --version预期输出类似v22.20.0再验证 npmnpm --version预期输出类似10.9.0如果两个命令都能正常输出版本号说明安装成功了。五、配置 npm5.1 修改全局模块安装路径npm 默认把全局模块装在 C 盘C 盘空间宝贵建议改到其他盘。在 Node.js 安装目录比如D:\NodeJs\Node下新建两个文件夹D:\NodeJs\Node\node_global ← 全局模块 D:\NodeJs\Node\node_cache ← 缓存创建完毕后复制刚刚创建的【node_global】和【node_cache】文件夹路径在cmd命令分别输入以下两条命令注意不要两条命令的文件路径不要搞混了。注可以打开所创建的文件夹把鼠标放在箭头指向的位置选择复制。使用管理员身份打开cmd命令窗口输入以下命令下面的路径是我创建的文件夹所在的路径需要复制你们自己创建的路径哦然后在命令行里设置#npm config set prefix “你的路径\node_global” #复制刚刚所创建的“node_global”文件夹路径 npm config set prefix D:\NodeJs\Node\node_global #npm config set cache “你的路径\node_cache” #复制刚刚所创建的“node_cache”文件夹路径 npm config set cache D:\NodeJs\Node\node_cache5.2 把新的 global 路径加入 PATH不然后续用npm install -g xxx装的全局命令会找不到。打开环境变量 → 在系统变量Path中把原来的D:\NodeJs\Node\node_global之前的 npm 默认路径删掉如果有的话添加一条新记录D:\NodeJs\Node\node_global(将默认的 C 盘下【AppData\Roaming\npm】修改成 【node_global】的路径)在【系统变量】中选择【Path】点击【编辑】后点击新建【%NODE_PATH%】顺便把D:\NodeJs\Node也确认在 PATH 里。5.3 配置淘宝镜像国内必备npm 默认去registry.npmjs.org拉包国内下载容易超时或极慢。换成国内镜像npm config set registry https://registry.npmmirror.com验证是否生效npm config get registry应该输出https://registry.npmmirror.com。如果想装cnpm命令行工具也可以非必需npm install -g cnpm --registryhttps://registry.npmmirror.com六、常见问题与解决6.1 安装后 node 命令找不到现象node 不是内部或外部命令也不是可运行的程序排查步骤确认D:\NodeJs\Node已加入系统 PATH关掉当前命令行窗口新开一个再试环境变量不会自动刷新如果还不行重启电脑6.2 能找到 node 但无法运行现象程序node无法运行: 找不到应用程序所在位置或者用where.exe node看到输出类似C:\Windows\System32\node ← 一个假文件排在前面 D:\NodeJs\Node\node.exe ← 真正的 node原因C:\Windows\System32里有一个叫node的 0 字节空文件可能是某个程序卸载后的残留或 Windows 应用执行别名它在 PATH 中的搜索优先级比你装的 Node 高。解决用管理员 PowerShell 删掉它Remove-Item C:\Windows\System32\node -Force6.3 npm 全局安装的包找不到命令现象比如执行npm install -g yarn成功但敲yarn报找不到命令。原因npm 全局模块目录没在 PATH 里。解决确认D:\NodeJs\Node\node_global已加入系统 PATH。6.4 npm install 报权限错误Error: EPERM现象Error: EPERM: operation not permitted解决用管理员身份打开命令行再执行或者前面已经配置了把全局路径改到 D 盘的话一般不会遇到这个问题。6.5 安装时提示 2502 / 2503 错误现象运行.msi安装包时报 2502 或 2503 错误。解决用管理员身份运行安装包。右键.msi文件 → 以管理员身份运行。或者用管理员 CMD 执行msiexec /package 你下载的安装包路径.msi七、版本管理工具进阶如果你需要在不同项目间切换 Node.js 版本可以考虑装一个版本管理器nvm-windowshttps://github.com/coreybutler/nvm-windowsfnmhttps://github.com/Schniz/fnm 跨平台更快装好 nvm 后可以自由切换版本nvm install 22.20.0 # 安装指定版本 nvm use 22.20.0 # 切换到指定版本 nvm list # 查看已安装的版本总结步骤不复杂记住几个关键点去官网下 LTS 版本网速慢就用国内镜像安装路径别放 C 盘记得勾选 Add to PATH装完改 npm 的全局路径和缓存路径到非 C 盘国内用户一定要配淘宝镜像不然下载等到天荒地老遇到node命令诡异报错先where.exe node排查是不是被假文件劫持了