目录

一、Node.js 是什么？为什么你几乎一定会用到它

二、安装前先搞清楚：该选哪个版本

三、Node.js 下载步骤

四、Node.js 安装步骤详解

五、怎么判断自己到底装成功了

为什么有些教程还要配置 node_global 和 node_cache

六、配置 npm 全局目录和缓存目录

七、环境变量怎么配

八、为什么 npm 下载很慢？顺手把镜像源也配了

九、安装一个包测试一下，确认整个环境真没问题

十、安装过程中最容易踩的坑，我帮你提前避开

十一、装好 Node.js 之后，你就可以做什么了

十二、总结段

可直接复制的命令汇总

        如果你刚开始学前端、想跑 Vue/React 项目，或者准备安装 Claude Code、Codex、npm 包工具链，那么 Node.js 几乎是绕不过去的第一步。
        很多人不是学不会，而是第一次安装时总会卡在版本选择、环境变量、npm 下载慢、权限报错这些小坑上。
        这篇教程我会带你从 下载安装到验证可用，再到 npm 镜像配置 全流程走一遍，尽量做到你照着操作就能装好。

---

一、Node.js 是什么？为什么你几乎一定会用到它

        Node.js 是一个 JavaScript 运行环境，它让 JavaScript 不再只能跑在浏览器里，也能在本地电脑和服务器上执行。
        对开发者来说，它最重要的价值之一是自带 npm，也就是 JavaScript 世界最常用的包管理工具，很多项目创建、依赖安装、脚手架运行都离不开它。
        像 Vue、React、Next.js、Vite、Electron，甚至很多 AI 编程工具和 VS Code 扩展的底层命令，都依赖 Node.js 环境。

二、安装前先搞清楚：该选哪个版本

        去官网下载时，你通常会看到不同版本，但对大多数普通用户和初学者来说，优先选择 LTS 版本 就够了。
        LTS 的意思是长期支持版，稳定、兼容性好，适合日常开发、学习和大多数项目环境。
除非你明确知道自己在追新特性，否则不建议一上来就选最新实验性版本。

你可以这样理解：

• 学习前端、跑项目、装常用工具：选 LTS。

• 追最新特性、做特定版本测试：再考虑 Current 或其他新版本。

三、Node.js 下载步骤

        第一步，打开 Node.js 官网下载页面，选择 Windows 对应安装包，一般下载 .msi 安装程序即可。
对于 Win11 用户，常见做法就是直接下载 Windows Installer，这种方式最省事，适合绝大多数人。
下载完成后，你会得到一个安装文件，双击即可开始安装。

在这提醒大家：

• 尽量从官网下载安装包；

• 不要随便从不明网站下“绿色版”或“魔改版”；

• 新手优先用官方安装器，少走弯路。

四、Node.js 安装步骤详解

双击安装包后，会进入安装向导。整个过程并不复杂，基本就是一路 Next，但我建议你每一步都知道自己在点什么。

1. 欢迎界面

点击 Next 进入下一步即可。

2. 勾选协议

看到许可协议页面后，勾选 I accept the terms in the License Agreement，然后点击 Next。

3. 选择安装目录

        这里你可以保持默认路径，也可以改到自己习惯的目录。
        如果你电脑 C 盘空间紧张，或者你本来就习惯把开发环境装到 D 盘，可以改到类似 D:\nodejs 这样的路径。
        如果你是新手，不想折腾路径问题，保持默认也完全没问题。

4. 选择安装组件

这一页一般保持默认即可，不建议新手乱改。
默认安装通常已经包含 Node.js 运行环境、npm，以及必要的工具项，足够你后续使用。

5. 关于自动安装工具的选项

        有些安装流程里会出现与 Native Modules 或附加工具相关的选项，通常新手可以先保持默认，不额外折腾。
因为很多人第一次安装并不会立刻用到这些功能，真有需要，后面缺什么再补什么更稳妥。

6. 点击安装

确认无误后，点击 Install 开始安装。
如果系统弹出管理员权限确认窗口，点“是”即可，这是 Windows 常见的 UAC 提示。

7. 安装完成

等进度条跑完，点击 Finish，Node.js 就已经安装到你的电脑里了。

五、怎么判断自己到底装成功了

        很多人以为“安装完成”就代表一切结束了，其实还差最后一个最关键的验证步骤：看命令能不能正常执行。

按下 Win + R，输入 cmd，回车打开命令提示符窗口。
然后依次输入下面两条命令：

node -v
npm -v

如果终端正常输出版本号，就说明 Node.js 和 npm 都已经安装成功了。

例如你可能会看到类似这样的输出：

只要有版本号，不一定非要和我一模一样，基本就说明环境没问题。

---

为什么有些教程还要配置 node_global 和 node_cache

        到这里，其实你已经可以开始用 Node.js 了。
但很多详细教程还会继续教你配置 node_global 和 node_cache，原因很简单：把 npm 的全局安装目录和缓存目录改到你更容易管理的位置。

        默认情况下，npm 的一些全局包和缓存可能会放在系统用户目录下，不够直观，也不方便统一整理。
        如果你以后会装很多全局工具，比如 pnpm、yarn、vite、typescript、@anthropic-ai/claude-code 这类 CLI，那么提前整理目录会省不少事。
所以这一步不是“必须才能用”，而是“建议你现在顺手做好，后面更舒服”。

六、配置 npm 全局目录和缓存目录

假设你的 Node.js 安装目录是 D:\nodejs，那么你可以在这个目录下手动创建两个文件夹：

• node_global

• node_cache

创建完成后，打开命令提示符，执行如下命令：

npm config set prefix "D:\nodejs\node_global"
npm config set cache "D:\nodejs\node_cache"

这两条命令的作用是：

• prefix：指定 npm 全局安装包的位置；

• cache：指定 npm 缓存文件的位置。

如果你的安装目录不是 D 盘，把路径替换成你自己的真实路径即可。

七、环境变量怎么配

        如果你修改了 npm 全局目录，那么还需要把新的全局目录加入系统环境变量，不然你安装的一些全局命令可能无法直接使用。

操作路径一般是：

1. 右键“此电脑”或“我的电脑”，进入“属性”；

2. 点击“高级系统设置”；

3. 打开“环境变量”；

4. 找到 Path 变量并编辑；

5. 把你的 node_global 路径加进去，比如 D:\nodejs\node_global。

        有些教程还会额外配置 NODE_PATH，但对很多日常开发场景来说，最核心的是确保全局 npm 路径已经加进 Path。
        环境变量就像告诉系统“以后去哪里找这些命令”，不配的话，包虽然装上了，命令却可能找不到。

八、为什么 npm 下载很慢？顺手把镜像源也配了

        很多人装完 Node.js 后第一次执行 npm install 就开始怀疑人生，不是卡住，就是特别慢。
原因通常不复杂：npm 默认从国外源拉包，国内网络环境下速度常常不太理想。

你可以先查看当前源

npm config get registry

如果想提高下载速度，可以切换为国内镜像，例如：

npm config set registry https://registry.npmmirror.com

然后再检查一次：

npm config get registry

如果输出的是你刚设置的镜像地址，说明修改成功了。

九、安装一个包测试一下，确认整个环境真没问题

只看 node -v 和 npm -v 还不够过瘾，最实在的方式是直接装一个包试试。
你可以执行下面这条命令安装一个全局工具：

npm install -g express-generator

如果安装过程正常跑完，没有报错，说明 npm、网络、路径配置基本都通了。
安装完成后，你还可以输入：

express --version

如果能输出版本号，说明全局命令已经生效。

如果你只想做一个最简单的测试，也可以安装别的轻量包，核心是验证“我能成功下载并调用全局命令”。

十、安装过程中最容易踩的坑，我帮你提前避开

1. 输入 node -v 提示不是内部或外部命令

这通常说明环境变量还没生效，或者命令行窗口开得太早了。
你可以先关闭当前 cmd，重新打开再试一次；如果还不行，就检查 Node.js 安装路径和 Path 配置是否正确。

2. npm 安装包时特别慢或者卡住

优先检查镜像源是否还是默认国外地址，改成国内镜像通常能明显改善。

3. 全局安装时报权限错误

有些教程提到，全局安装失败可能和权限有关，必要时可以尝试以管理员身份运行 cmd 或检查目录权限。

4. 不知道该装哪个版本

记住一句话：不会选，就选 LTS。

十一、装好 Node.js 之后，你就可以做什么了

安装完成后，你基本就拥有了现代前端和很多 JS 工具链的入口。
你可以继续做这些事：

• 安装 Vue、React、Vite、Next.js 等项目脚手架；

• 安装常见全局工具，如 pnpm、yarn、typescript；

• 在 VS Code 里运行前端项目；

• 为 Claude Code、Codex 一类需要 Node 环境的 CLI 做准备。

这也是为什么很多人说：Node.js 不是“前端某个可选工具”，而是现代开发环境的一块基础地板。

十二、总结段

如果你是第一次接触前端开发，不要把 Node.js 安装想得太难。
你真正需要完成的就四步：下载 LTS 版本、按向导安装、命令行验证、顺手配置 npm 镜像。
把这套环境搭好之后，你后面装项目依赖、跑脚手架、使用 AI 编程工具，都会顺畅很多。

可直接复制的命令汇总

node -v
npm -v

npm config set prefix "D:\nodejs\node_global"
npm config set cache "D:\nodejs\node_cache"

npm config get registry
npm config set registry https://registry.npmmirror.com
npm config get registry

npm install -g express-generator
express --version