适用于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管理多个版本,避免冲突。
- 若需进一步帮助,请提供错误信息,我可协助排查。