在 macOS 上使用 Homebrew 安装 Node.js 的完整指南

在 macOS 上使用 Homebrew 安装 Node.js 的完整指南

1. 准备工作

首先确保你已经安装了 Homebrew（macOS 上最流行的包管理器）：

# 检查是否已安装 Homebrew brew --version # 如果未安装，使用以下命令安装 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. 安装 Node.js

方法一：安装最新稳定版（推荐）

brew installnode

方法二：安装特定版本

# 先搜索可用的 Node.js 版本 brew search node# 安装特定版本（如 18.x） brew install node@18 

3. 安装后的验证

# 检查 Node.js 版本node -v # 检查 npm 版本npm -v # 检查 npx 版本 npx -v 

4. 环境变量配置（仅当安装特定版本时需要）

如果你安装了特定版本的 Node.js（如 node@18），需要手动添加环境变量：

# 对于 bash/zsh 用户echo'export PATH="/usr/local/opt/node@18/bin:$PATH"'>> ~/.zshrc # 然后重新加载配置文件source ~/.zshrc 

5. 升级 Node.js

# 先更新 Homebrew brew update # 然后升级 Node.js brew upgrade node

6. 切换 Node.js 版本（可选）

如果你需要管理多个 Node.js 版本，可以使用 n 或 nvm：

使用 n 管理版本

# 安装 nnpminstall -g n # 安装特定版本 n 16.13.0 # 切换版本 n 

使用 nvm 管理版本

# 安装 nvm brew install nvm # 然后按照提示配置环境变量# 使用 nvm 安装和管理版本 nvm install14 nvm use 14

7. 卸载 Node.js

# 卸载 Node.js brew uninstall node# 如果需要彻底删除残留文件rm -rf /usr/local/lib/node_modules rm -rf ~/.npm 

常见问题解决

版本不匹配：如果 node 和 npm 版本显示不一致，可以尝试：

brew postinstall node

命令未找到：确保 Homebrew 的路径已添加到你的 shell 配置文件中：

echo'export PATH="/usr/local/bin:$PATH"'>> ~/.zshrc source ~/.zshrc 

权限问题：如果遇到权限错误，可以尝试：

sudochown -R $(whoami)$(brew --prefix)/* 

通过 Homebrew 安装 Node.js 是最简单、最推荐的方式，它能自动处理依赖关系并方便后续升级管理。