macOS 安装 Node.js

系统要求

• macOS 11.0 或更高版本
• Apple Silicon（M 系列）或 Intel 处理器均支持

方法一：使用 nvm（强烈推荐）

nvm 是 Node.js 版本管理工具，可以灵活切换版本，适合开发者使用。

安装 nvm

# 使用官方安装脚本
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# 重新加载 shell 配置
source ~/.zshrc   # 使用 zsh（macOS 默认）
# 或
source ~/.bashrc  # 使用 bash

安装 Node.js

# 安装最新 LTS 版本
nvm install --lts

# 查看可用版本
nvm ls-remote --lts

# 安装指定版本
nvm install 22

# 设置默认版本
nvm alias default 22

# 验证安装
node -v
npm -v

方法二：使用 Homebrew

# 先安装 Homebrew（如未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Node.js
brew install node

# 验证
node -v
npm -v

方法三：官网下载安装包

1. 访问 Node.js 官网
2. 下载 macOS 安装包（.pkg 格式），注意选择对应芯片版本
3. 双击安装，按提示完成安装

配置 npm 镜像

# 设置淘宝镜像
npm config set registry https://registry.npmmirror.com

# 或使用 nrm 管理镜像
npm install -g nrm
nrm use taobao

Apple Silicon（M 系列）注意事项

使用 Homebrew 安装时，需要确保终端在原生 arm64 模式下运行（非 Rosetta）：

# 检查当前架构
uname -m  # 应输出 arm64

# 确认 Node.js 架构
node -p process.arch  # 应输出 arm64

常见问题

Q: zsh: command not found: nvm

A: 确认 ~/.zshrc 中包含 nvm 初始化代码，运行 source ~/.zshrc 后重试。

Q: npm 安装全局包时权限错误？

A: 使用 nvm 安装的 Node.js 无需 sudo，若遇到权限问题请检查是否使用了系统自带的 Node.js。