2025 最新版 Node.js 下载安装及环境配置教程
一、版本选择说明
根据 Node.js 官方发布计划，截至 2025 年 9 月，当前处于Active LTS（长期支持）状态的版本为Node.js v22.x（代号 "Jod"），该版本于 2024 年 4 月发布，将提供长期支持至 2027 年 4 月，是生产环境的最优选择。
⚠️ 注意：Node.js 的奇数版本（如 v23）为短期开发版本，已在 2025 年 5 月停止支持，不建议用于生产环境；官网默认展示的v22.19.0(LTS) 是 v22.x 线路的最新稳定小版本，包含截至发布时所有安全漏洞修复和 Bug 修复，安全性与兼容性更优，因此优先选择该版本。
二、下载地址获取
1. 官方下载渠道
在官网首页 "长期支持版 (LTS)" 栏目下，通过版本下拉框可直接选择v22.19.0，获取对应系统的安装包。
2. 国内镜像加速
针对国内用户下载速度慢的问题，推荐使用以下镜像站（搜索 "v22.19.0" 即可找到对应安装包）：
- 淘宝 NPM 镜像：https://registry.npmmirror.com
- 华为云镜像：https://mirrors.huaweicloud.com/nodejs/
三、Windows 系统安装步骤（以 Win11 为例）
1. 下载安装包
从官网或镜像站下载对应系统架构的安装包：
- 64 位系统：选择 "node-v22.19.0-x64.msi"
- 32 位系统：选择 "node-v22.19.0-x86.msi"
2. 图形化安装过程
- 双击安装包，在欢迎界面点击 "Next"
- 同意许可协议后点击 "Next"
- 自定义安装路径（建议路径不含空格和中文，如D:\Develop\nodejs）
- 关键步骤：在 "Custom Setup" 界面，勾选 **"Add to PATH"** 选项，自动配置环境变量
- 点击 "Install" 开始安装，完成后点击 "Finish"
3. 验证安装
- 按下Win+R，输入cmd打开命令提示符
- 分别执行以下命令验证版本：
node -v # 应输出 v22.19.0 npm -v # 应输出对应捆绑版本（通常为10.x或11.x系列）四、macOS 系统安装步骤
1. 方法一：使用 Homebrew（推荐）
验证安装：
node -v # 应输出 v22.19.0 npm -v # 验证npm版本安装 Node.js v22.19.0（Homebrew 会自动拉取该版本）：
brew install node@22 # 明确指定v22系列，自动安装最新小版本（即22.19.0）若未安装 Homebrew，先执行安装命令：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"2. 方法二：官网 pkg 安装包
- 从官网下载 macOS 版本的 "node-v22.19.0.pkg" 安装包
- 双击安装包，按照向导完成安装（默认自动配置环境变量）
- 打开终端，执行上述验证命令
⚠️ 注意：M1/M2 芯片 Mac 用户建议使用 Homebrew 安装，可避免架构适配问题
五、环境配置优化
1. npm 镜像源配置
默认 npm 源在国内访问较慢，推荐配置国内镜像：
方法一：命令行配置（永久生效）
# 配置淘宝镜像 npm config set registry https://registry.npmmirror.com # 验证配置 npm config get registry # 应输出配置的镜像地址方法二：配置文件设置（推荐）
- 在用户主目录（C:\Users\用户名或~）创建.npmrc文件
- 保存后立即生效，无需额外命令
添加内容：
registry=https://registry.npmmirror.com2. 可选镜像源列表
除淘宝镜像外，还可选择：
六、pnpm 包管理器安装
作为更高效的包管理器，推荐安装 pnpm（版本适配 v22.19.0）：
1. 使用 npm 安装（通用方法）
npm install -g pnpm@latest-10 # 10.x系列与v22.19.0兼容性最佳2. Windows 系统专用方法
$env:PNPM_VERSION = "10.9.2"; Invoke-WebRequest https://get.pnpm.io/install.ps1 -UseBasicParsing | Invoke-Expression⚠️ 注意：Windows Defender 可能拦截独立安装程序，建议优先使用 npm 方式安装
3. macOS/Linux 系统
curl -fsSL https://get.pnpm.io/install.sh | env PNPM_VERSION=10.9.2 sh -七、安装验证与测试
1. 创建测试项目
# 创建项目目录 mkdir node-test && cd node-test # 初始化项目 npm init -y # 或使用pnpm init -y # 创建测试文件 echo "console.log('Node.js v' + process.version)" > index.js2. 运行测试
node index.js # 应输出 Node.js v22.19.03. 安装依赖测试
# 安装express框架测试环境兼容性 npm install express # 或 pnpm install express若安装过程无报错，且node_modules目录正常生成，则环境配置成功。
八、常见问题解决
1. 安装失败
- 确保以管理员权限运行安装程序（Windows）或加sudo（macOS/Linux）
- 关闭杀毒软件和防火墙重试
清除 npm 缓存后重试：
npm cache clean -f2. 命令未找到（command not found）
- 检查环境变量是否包含 Node.js 安装路径（Windows：系统属性→高级→环境变量→Path；macOS/Linux：echo $PATH）
- Windows 用户可重启命令提示符或电脑；macOS/Linux 用户可执行source ~/.bashrc或source ~/.zshrc刷新环境变量
3. 版本切换需求
如需管理多个 Node.js 版本，推荐使用 nvm：
九、版本支持周期参考
版本 | 状态 | 支持开始 | 支持结束 |
v24 | Current（开发版） | 2025.5 | 短期支持（约 6 个月） |
v22 | Active LTS（长期支持） | 2024.4 | 2027.4 |
v20 | Maintenance LTS（维护版） | 2023.4 | 2026.4 |
注：v22.x 系列的小版本（如 22.19.0）会持续更新至 2027.4，每次更新仅包含安全修复和 Bug 修复，不影响项目兼容性。
