🔥个人主页：北极的代码（欢迎来访）
🎬作者简介：java后端学习者
❄️个人专栏：苍穹外卖日记，SSM框架深入，JavaWeb
✨命运的结局尽可永在，不屈的挑战却不可须臾或缺！
前言：
今天在GitHub上找一个签到脚本的时候，发现还需要Node.Js，（至于为什么不用Python，因为之前搞过一个Python的环境，我个人感觉没删干净，不太想弄，下次再专门弄弄吧）然后自己下载安装，发现还是有很多的坑点，这里分享一下
摘要：
本文详细介绍了Node.js环境配置的完整方案，重点解决新手安装过程中的常见问题。文章推荐使用nvm管理Node版本，并提供了Windows/Mac系统的具体安装步骤，强调卸载旧版本、正确设置路径等关键点。同时讲解了npm换源提速、nrm管理镜像源等实用技巧，并列举了5个典型错误的解决方法。最后通过创建测试服务器验证环境配置成功，建议开发者保存本文以备后续装机使用。全文提供了从安装到验证的完整流程，帮助开发者快速搭建稳定高效的Node.js开发环境。
正文开始
读完这篇文章，你将学会：
✅ 在 Windows / Mac 上正确安装 Node.js
✅ 解决npm命令找不到、安装超慢的问题
✅ 用nvm轻松切换 Node 版本
✅ 避开 90% 新手遇到的“权限报错”“中文路径坑”
Node.js 到底能干什么（三大核心用途）
1. 写后端接口 / 服务器
最常见的用途。你用 Node.js 写一个程序，别人访问http://你的电脑IP:3000，就能收到数据。
javascript
// 一个最简单的后端服务器 const http = require('http'); http.createServer((req, res) => { res.end('Hello Node.js'); }).listen(3000);实际应用：抖音/小红书的后台有一部分就是 Node.js 写的，你刷到的视频列表就是从 Node.js 服务器返回的。
2. 前端开发的必需品
你现在看到的 Vue、React、微信小程序这些前端项目，开发阶段都必须依赖 Node.js。
你需要 Node.js 来：
下载项目依赖的第三方代码库（npm install）
把代码打包、压缩、自动刷新浏览器
运行本地测试服务器
很多前端开发甚至不需要写 Node.js 代码，但是必须装 Node.js，因为开发工具依赖它。
3.写自动化脚本（效率神器）
用 Node.js 写一段脚本，可以：
自动把文件夹里的 100 张图片改名
定时爬取某个网站的数据
批量处理 Excel / Word 文件
一、Node.js 环境配置为什么难倒那么多新手
打开搜索引擎搜“Node.js 安装教程”，你会发现：
有人让你去官网下一个
.exe一路点“下一步”有人让你用命令行装，但一运行就报错
装完之后发现
npm install永远卡在fetchMetadata更惨的是，换个项目需要不同 Node 版本，只能卸载重装
问题的本质：大多数教程只教“怎么装”，不教“怎么装得对、装得稳、后续不麻烦”。
二、Node.js 环境配置的完整路线
一句话方案：
用 nvm 安装 Node，用 npm 换源，用 nrm 管理源
完整的推荐步骤：
安装
nvm（Node 版本管理工具）用
nvm安装 Node.js配置 npm 国内镜像源（提速 10 倍）
验证环境
（可选）安装
nrm管理多个源
三、Windows 篇（图文级详细）
3.1 第一步：卸载已有的 Node.js（如果你装过）
如果你之前从官网装过 Node.js，先彻底卸载：
控制面板 → 卸载程序 → 卸载 Node.js
删除这两个文件夹（如果存在）：
C:\Program Files\nodejsC:\Users\你的用户名\AppData\Roaming\npmC:\Users\你的用户名\AppData\Roaming\npm-cache
⚠️ 不卸载干净，后面 nvm 切换版本会冲突。
3.2 第二步：安装 nvm（核心工具）
下载地址：nvm-windows 最新版
下载文件：
nvm-setup.exe
安装时的两个关键选项（很多人错在这里）：
NVM 安装路径：保持默认
C:\Users\你的用户名\nvm（不要改）Node.js 安装路径：必须改成
C:\Program Files\nodejs
为什么？只有这样才能让 nvm 接管 Node 版本切换，后续
node -v才能正常识别。
安装完成后，重启终端（cmd 或 PowerShell）。
3.3 第三步：用 nvm 安装 Node.js
打开 cmd 或 PowerShell，依次执行：
cmd
# 查看可用的 Node 版本（选 LTS 长期支持版） nvm list available # 安装最新 LTS 版本（示例：20.x 是 2026 年主流） nvm install 20.18.0 # 切换到该版本 nvm use 20.18.0 # 设置默认版本（重启终端后自动生效） nvm alias default 20.18.0
3.4 第四步：验证安装（小白必做）
关闭当前终端，打开一个全新的 cmd，输入：
cmd
node -v npm -v
如果分别显示版本号（如v20.18.0和10.8.2），说明Node.js 环境配置成功。
常见报错：
'node' 不是内部或外部命令→ 99% 是因为安装 nvm 后没有重启终端。
四、Mac / Linux 篇（更简单）
打开终端，依次执行：
bash
# 1. 安装 nvm（macOS/Linux） curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash # 2. 重启终端（或者执行下面两行让 nvm 立即生效） export NVM_DIR="$HOME/.nvm" [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # 3. 安装 Node.js nvm install --lts # 安装最新 LTS 版本 nvm use --lts # 切换使用 nvm alias default 'lts/*' # 4. 验证 node -v npm -v
五、最关键的提速操作：npm 换源
默认 npm 下载包是从国外服务器拉取，速度极慢，必须换成国内镜像。
方式一：临时使用（推荐新手测试）
bash
npm install 包名 --registry=https://registry.npmmirror.com
方式二：永久设置（推荐）
bash
npm config set registry https://registry.npmmirror.com
验证是否配置成功：
bash
npm config get registry
应该显示：https://registry.npmmirror.com/
效果：原本需要 5 分钟的npm install，现在 30 秒内完成。
六、进阶技巧：用 nrm 一键切换 npm 源（很多人不知道）
如果你需要在内网、外网、公司源之间切换，装一个nrm会非常方便。
bash
npm install -g nrm # 查看所有可用源 nrm ls # 切换到淘宝源 nrm use taobao # 切换到官方源 nrm use npm
这个工具在小红书、B站上有很多人问，你装好之后发个截图，评论区会有人问你怎么做的。
七、新手最常遇到的 5 个错误及解决办法
| 错误现象 | 根本原因 | 解决方式 |
|---|---|---|
npm install卡住不动 | 没换源 | 执行npm config set registry https://registry.npmmirror.com |
node -v正常但npm -v报错 | npm 没跟随 Node 安装 | 重新用 nvm 执行nvm install 版本再nvm use |
nvm use报错退出码 1 | 安装 nvm 时路径没改对 | 卸载 nvm 重装，注意 Node 路径选C:\Program Files\nodejs |
npm install -g xxx报权限错误 | 文件夹权限问题 | 不用修，直接用 nvm 装 Node 就不会有这个问题 |
Error: ENOENT | 在没package.json的目录执行命令 | 先npm init -y再操作 |
八、如何验证你的 Node.js 环境真的配好了
在你电脑上任意位置新建一个文件夹，创建一个test.js文件：
javascript
// test.js const http = require('http'); const server = http.createServer((req, res) => { res.end('Hello Node.js 环境配置成功！'); }); server.listen(3000, () => { console.log('访问 http://localhost:3000'); });运行：
bash
node test.js
打开浏览器访问http://localhost:3000，看到文字说明一切完美。
九、最终建议
不要从官网直接下载 .exe 装 Node，用
nvm才是正确方式。npm 必须先换源，不然你会怀疑自己电脑有问题。
每次换项目前先确认 Node 版本：
node -v把本文保存下来，下次重装电脑或换工作电脑时，照着做 10 分钟就能恢复环境。
你按照这篇文章装 Node.js 成功了吗？
如果遇到了本文没写到的报错，欢迎评论区留言，我会帮你排查。
收藏这篇文章，你以后装机一定用得到。
