Node.js v22 安装与环境配置指南

若未安装 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 修复，不影响项目兼容性。