Mac mini M4 安装 Node.js 22 教程
方法一:使用 Homebrew 安装(推荐,最简单)
步骤 1:安装 Homebrew(如未安装)
bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
步骤 2:安装 Node.js 22
bash
# 安装指定版本 22
brew install node@22
# 或者安装最新版
brew install node
步骤 3:添加到环境变量
bash
echo 'export PATH="/opt/homebrew/opt/node@22/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
步骤 4:验证安装
bash
node -v # 应显示 v22.x.x
npm -v # 应显示 10.x.x
注意:Node.js v16 及以上版本原生支持 Apple Silicon (ARM64),能充分发挥 M4 芯片性能,无需 Rosetta 2 转译
方法二:使用 NVM 安装(推荐需要多版本管理的开发者)
步骤 1:安装 NVM
bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
步骤 2:加载 NVM
bash
source ~/.zshrc
# 或重新打开终端
步骤 3:配置国内镜像(可选,加速下载)
bash
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node/
# 将上述行添加到 ~/.zshrc 以永久生效
步骤 4:安装 Node.js 22
bash
nvm install 22
步骤 5:设置默认版本并使用
bash
nvm use 22
nvm alias default 22
步骤 6:验证安装
bash
nvm ls # 查看已安装版本
node -v # 查看当前 Node 版本
npm -v # 查看 npm 版本
方法三:官方安装包安装
- 访问 Node.js 官网
- 下载 LTS 版本的 macOS ARM64 安装包(
node-v22.x.x.pkg) - 双击运行安装包,按提示完成安装
- 验证:
node -v
安装后配置(推荐)
配置 npm 国内镜像源:
bash
# 使用阿里云镜像
npm config set registry https://registry.npmmirror.com
# 验证
npm config get registry
启用 Corepack(Node 22 内置功能,管理 yarn/pnpm 版本):
bash
corepack enable
常见问题
| 问题 | 解决方案 |
|---|---|
command not found: node |
检查 PATH 配置,执行 source ~/.zshrc |
| 权限错误 | 避免使用 sudo 安装 npm 包,修复目录权限:sudo chown -R $(whoami) ~/.npm |
| 版本切换无效 | 使用 nvm use 22 激活指定版本 |
总结建议
- 新手/简单使用 :选择 Homebrew 安装,一键搞定
- 需要多版本切换 :选择 NVM,灵活管理不同项目需求