适用于macOS 10.15及以上版本。
前提条件
- macOS版本:确保系统为macOS 10.15(Catalina)或更高版本。可在"苹果菜单 > 关于本机"查看。
 - 管理员权限:部分安装可能需要管理员权限。
 - 网络连接:需要联网下载安装包或工具。
 
安装方法
以下是三种常用的安装Node.js方法,按推荐顺序排列:
方法 1:使用Homebrew(推荐)
Homebrew 是Mac上常用的包管理器,安装简单且便于管理版本。
- 
安装Homebrew(若未安装):
- 
打开终端(位于"应用程序 > 实用工具 > 终端")。
 - 
运行以下命令安装Homebrew:
bash/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 
按提示输入密码并回车,安装过程可能需要几分钟。
 - 
安装完成后,配置Homebrew环境变量(根据提示添加至
~/.zshrc或~/.bashrc):bashecho 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc source ~/.zshrc 
 - 
 - 
安装Node.js:
- 
在终端运行:
bashbrew install node - 
Homebrew会自动安装最新LTS版本的Node.js和npm。
 
 - 
 - 
验证安装:
- 
检查Node.js版本:
bashnode --version - 
检查npm版本:
bashnpm --version - 
输出类似
v18.x.x(Node.js)和9.x.x(npm)表示安装成功。 
 - 
 
方法 2:直接从Node.js官网下载
适合不想使用包管理器的用户。
- 
访问Node.js官网:
- 打开浏览器,前往 nodejs.org。
 - 推荐下载 LTS版本 (长期支持版,稳定),点击"LTS"按钮下载 
.pkg安装包。 
 - 
运行安装包:
- 双击下载的 
.pkg文件,启动安装向导。 - 按提示点击"继续",同意许可协议,选择安装位置(默认即可),输入管理员密码完成安装。
 - 安装程序会自动安装Node.js和npm。
 
 - 双击下载的 
 - 
验证安装:
- 
打开终端,运行:
bashnode --version npm --version - 
确认版本号输出。
 
 - 
 
方法 3:使用nvm(Node Version Manager)
适合需要管理多个Node.js版本的开发者。
- 
安装nvm:
- 
在终端运行以下命令安装nvm:
bashcurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash - 
安装完成后,关闭并重新打开终端,或运行:
bashsource ~/.zshrc - 
验证nvm安装:
bashnvm --version 
 - 
 - 
安装Node.js:
- 
安装最新LTS版本:
bashnvm install --lts - 
或指定版本,例如:
bashnvm install 18 - 
设置默认版本:
bashnvm use --lts nvm alias default --lts 
 - 
 - 
验证安装:
- 
检查Node.js和npm版本:
bashnode --version npm --version 
 - 
 
注意事项
- 权限问题 :
- 
若npm安装全局包时提示权限错误,避免使用
sudo。可修复npm权限:bashsudo chown -R $(whoami):admin ~/node_modules /usr/local/lib/node_modules - 
或使用nvm管理Node.js,避免权限问题。
 
 - 
 - 更新Node.js :
- Homebrew:运行 
brew upgrade node。 - nvm:运行 
nvm install --lts --reinstall-packages-from=current。 - 官网安装:重新下载最新 
.pkg安装。 
 - Homebrew:运行 
 - 卸载Node.js (如需要):
- Homebrew:
brew uninstall node。 - 官网安装:手动删除 
/usr/local/bin/node和/usr/local/lib/node_modules。 - nvm:
nvm uninstall <版本号>。 
 - Homebrew:
 - 防火墙/代理 :若下载缓慢,检查网络设置或使用国内镜像(如 
https://npmmirror.com/mirrors/node/)。 
问题排查
- 命令未找到 :确保环境变量正确配置,检查 
~/.zshrc或~/.bashrc中的PATH设置。 - 安装失败 :尝试更新Homebrew(
brew update)或清理缓存(brew cleanup)。 - 版本冲突:使用nvm管理多个版本,避免冲突。
 - 若需进一步帮助,请提供错误信息,我可协助排查。