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. 官方下载渠道​

• 中文官网：https://nodejs.org/zh-cn/download/​
• 英文官网：https://nodejs.org/en/download/​

在官网首页 "长期支持版 (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. 图形化安装过程​

1. 双击安装包，在欢迎界面点击 "Next"​
2. 同意许可协议后点击 "Next"​
3. 自定义安装路径（建议路径不含空格和中文，如D:\Develop\nodejs）​
4. 关键步骤：在 "Custom Setup" 界面，勾选 **"Add to PATH"** 选项，自动配置环境变量​
5. 点击 "Install" 开始安装，完成后点击 "Finish"​

3. 验证安装​

1. 按下Win+R，输入cmd打开命令提示符​
2. 分别执行以下命令验证版本：

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 安装包​

1. 从官网下载 macOS 版本的 "node-v22.19.0.pkg" 安装包​
2. 双击安装包，按照向导完成安装（默认自动配置环境变量）​
3. 打开终端，执行上述验证命令​

⚠️ 注意：M1/M2 芯片 Mac 用户建议使用 Homebrew 安装，可避免架构适配问题

五、环境配置优化​

1. npm 镜像源配置​

默认 npm 源在国内访问较慢，推荐配置国内镜像：​

方法一：命令行配置（永久生效）

# 配置淘宝镜像 npm config set registry https://registry.npmmirror.com # 验证配置 npm config get registry # 应输出配置的镜像地址

方法二：配置文件设置（推荐）​

1. 在用户主目录（C:\Users\用户名或~）创建.npmrc文件​
2. 保存后立即生效，无需额外命令

添加内容：

registry=https://registry.npmmirror.com

2. 可选镜像源列表​

除淘宝镜像外，还可选择：​

• 华为云：https://mirrors.huaweicloud.com/repository/npm/​
• 腾讯云：http://mirrors.cloud.tencent.com/npm/

六、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.js

2. 运行测试

node index.js # 应输出 Node.js v22.19.0

3. 安装依赖测试

# 安装express框架测试环境兼容性 npm install express # 或 pnpm install express

若安装过程无报错，且node_modules目录正常生成，则环境配置成功。​

八、常见问题解决​

1. 安装失败​

• 确保以管理员权限运行安装程序（Windows）或加sudo（macOS/Linux）​
• 关闭杀毒软件和防火墙重试​

清除 npm 缓存后重试：

npm cache clean -f

2. 命令未找到（command not found）​

• 检查环境变量是否包含 Node.js 安装路径（Windows：系统属性→高级→环境变量→Path；macOS/Linux：echo $PATH）​
• Windows 用户可重启命令提示符或电脑；macOS/Linux 用户可执行source ~/.bashrc或source ~/.zshrc刷新环境变量​

3. 版本切换需求​

如需管理多个 Node.js 版本，推荐使用 nvm：​

• Windows：nvm-windows（可直接安装 v22.19.0）​
• macOS/Linux：nvm（执行nvm install 22.19.0即可）​

九、版本支持周期参考​

注：v22.x 系列的小版本（如 22.19.0）会持续更新至 2027.4，每次更新仅包含安全修复和 Bug 修复，不影响项目兼容性。​