Node.js 极简安装指南（Mac / Windows / Linux 通用，含国内镜像）

Node.js 极简安装指南（Mac / Windows / Linux 通用，含国内镜像）

新手别再直接下官网安装包了。用 nvm 管 Node 版本，一行命令切换，配合国内镜像，10 分钟搞定且不污染系统。本文覆盖三大平台，照着做即可。

---

1、一句话介绍 nvm / node / npm 是什么

• node：JavaScript 在浏览器之外运行的环境，也是今天构建后端 API、CLI 工具、AI 应用交付层的最主流选择。
• npm：随 Node 一起装好的包管理器（装第三方库用）。
• nvm：Node 版本管理器，一行命令装 / 切 / 卸多个 Node 版本，不污染系统目录。

---

2、安装 nvm（Mac / Linux）与 nvm-windows（Windows）

• macOS / Linux ：brew install nvm 或官方脚本 curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.6/install.sh | bash，再把 NVM 配置写进 ~/.zshrc（或 ~/.bashrc）。

# 下载并安装 nvm：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

# 代替重启 shell
\. "$HOME/.nvm/nvm.sh"

nvm --version

安装脚本通常会自动把 NVM 配置写进你的 shell 配置文件（Mac 新版默认 zsh，对应 ~/.zshrc；bash 用户改 ~/.bashrc）。若没生效，手动在文件末尾追加后执行 source ~/.zshrc 即可。

• Windows ：nvm 不支持 Windows！用社区版 nvm-windows （下载 nvm-setup.exe）。 Windows 用户去 nvm-windows releases 下载 nvm-setup.exe 双击安装，建议路径非中文、无空格（如 D:\dev\nvm）。

• 验证：nvm --version（Mac/Linux）/ nvm version（Windows）。

---

3、配置 nvm 下载镜像（★ 必须在「安装 node」之前）

目的：让 nvm 从国内镜像拉 Node 二进制，否则下载慢甚至超时。

macOS / Linux ：设环境变量（写进 ~/.zshrc）

export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node/
export NVM_NPM_MIRROR=https://npmmirror.com/mirrors/npm

Windows ：编辑 nvm 安装目录下的 settings.txt，追加

node_mirror: https://npmmirror.com/mirrors/node/
npm_mirror: https://npmmirror.com/mirrors/npm/

镜像地址清单见第 10.1 节。可参考nvm配置国内镜像源加速Node.js下载

---

4、安装 node

这里以当前最新 LTS Node 24 为例，版本选择的原因详见下一节。

nvm install 24          # 装最新 LTS（或 nvm install --lts / 精确版本号）
nvm use 24
nvm alias default 24    # 钉死默认版本，新终端自动用

---

5、Node.js 版本体系与选版建议

5.1 版本号规则

Node.js 遵循 semver（语义化版本），格式为 主版本.次版本.补丁版本（如 24.5.0）。

历史上 Node.js 每半年发一个大版本，版本号策略是：

• 偶数版本 （18、20、22、24...）→ LTS（长期支持），适合生产环境
• 奇数版本（19、21、23...）→ 实验性版本，生命周期短，几乎没人用

但从 Node.js 27（2027 年 4 月）开始，这一规则将改变 ：改为每年一个主要版本，不再发布奇数版本，每个版本都会成为 LTS。新流程为 Alpha（6 个月）→ Current（6 个月）→ LTS（18 个月 Active + 12 个月 Maintenance），总支持周期约 3 年。

5.2 LTS 是什么？

LTS（Long Term Support，长期支持）表示该版本会持续收到安全补丁和关键 bug 修复。整个生命周期分两个阶段：

阶段	时长	说明
Active LTS	~18 个月	积极维护，持续接收新特性移植和安全修复
Maintenance LTS	~12 个月	仅修复严重 bug 和安全漏洞，不再新增特性

截止日期后版本进入 EOL （End of Life），不再接收任何更新，请务必停止使用。

5.3 当前各版本状态（截至 2026 年 7 月）

版本	代号	当前状态	LTS 开始	EOL（停止支持）
Node 26	---	Current	2026-10	2029-04
Node 24	Krypton	Active LTS	2025-10	2028-04
Node 22	Jod	Maintenance LTS	2024-10	2027-04
Node 20	Iron	❌ EOL	---	2026-04

5.4 选版本建议

• 生产 / 学习一律用 Active LTS 。目前是 Node 24（Krypton）
• Node 22（Jod）仍在维护期也可用，但不推荐新项目
• Node 20 已 EOL，别装
• 看项目 package.json 的 engines 字段（如 Pi 要求 >=22.19.0）
• 不知道装哪个 → 直接装最新 LTS（目前是 24）

---

6、验证安装

node -v     # 输出版本号
npm -v      # 输出版本号

两者都正常输出即成功。

---

7、配置 npm 镜像源

npm config set registry https://registry.npmmirror.com
npm config get registry     # 验证

可选镜像见第 10.2 节。

---

8、常见问题（FAQ）

• nvm use 24 提示 N/A: version not yet installed → 先 nvm install 24（use 只切不下载）
• Windows 切了版本 node -v 还是旧的 → 用管理员开终端；或关掉重开
• node -v 还是旧版 → which node（Mac/Linux）看路径是否落在 nvm 下；用 nvm alias default 24 钉死
• 国内下载慢/超时 → 检查第 3、7 节镜像是否配好
• 设错镜像想还原 → npm config delete registry；nvm-windows 删掉 settings.txt 里的 node_mirror/npm_mirror 两行

---

9、nvm / node / npm 命令速查

nvm

nvm install 24          # 安装 Node 24 大版本最新
nvm use 24              # 切换到 Node 24
nvm alias default 24    # 设为默认版本（新终端生效）
nvm ls                  # 查看本地已装版本
nvm ls-remote           # 查看远程可装版本
nvm uninstall 24        # 卸载指定版本
nvm current             # 查看当前使用的版本

node

node -v                 # 查看 Node 版本
node -e "console.log(1+1)"  # 直接执行一段 JS
node --watch app.js     # 监听文件变化自动重启（Node ≥ 18.11）
node --check app.js     # 只做语法检查，不执行
node --inspect app.js   # 开启调试端口 9229

npm

npm install             # 安装 package.json 中所有依赖
npm install -D <pkg>    # 安装并写入 devDependencies
npm ci                  # 按 lock 文件精确安装（CI 环境用）
npm run <script>        # 执行 package.json 中定义的脚本
npm config set registry <url>   # 设置镜像源
npm config get registry         # 查看当前镜像源

---

10、参考资源

10.1 Node 安装包镜像源（nvm 的 node_mirror / 直接下官方包时替换域名）

用于下载 node.exe、.pkg 或二进制，国内主流云厂商均有同步官方 nodejs.org/dist 的发行版镜像。

镜像站	镜像地址	帮助 / 教程
淘宝（npmmirror）	https://npmmirror.com/mirrors/node/	无官方
腾讯云	https://mirrors.cloud.tencent.com/nodejs-release/	腾讯云 Node 镜像帮助
华为云	https://mirrors.huaweicloud.com/nodejs/	华为云 Node 镜像帮助
清华大学开源镜像站	https://mirrors.tuna.tsinghua.edu.cn/nodejs-release/	TUNA Node 镜像帮助

用法 ：nvm 用户把 node_mirror 指向表中其一；直接下官网包时把 nodejs.org/dist 域名替换成镜像域名即可。

10.2 npm 源（registry）

镜像站	镜像地址	帮助 / 教程
官方	https://registry.npmjs.org/	npm 官方文档
淘宝	https://registry.npmmirror.com/	阿里云 NPM 镜像帮助
腾讯云	http://mirrors.tencent.com/npm/	腾讯云 npm 镜像帮助
华为云	https://mirrors.huaweicloud.com/npm/	华为云 npm 镜像帮助
清华大学开源镜像站	https://mirrors.tuna.tsinghua.edu.cn/npm/	TUNA npm 镜像帮助

其他参考资料

• nvm 安装管理 Node 版本
• npm install加速指南：国内镜像源配置与优化方案

---

本文为极简版安装指南，覆盖 Mac / Windows / Linux 三大平台。版本数据截至 2026-07，安装前建议回官网核对最新 LTS 与 nvm 版本号。