适用于macOS 10.15及以上版本。

前提条件

• macOS版本：确保系统为macOS 10.15（Catalina）或更高版本。可在“苹果菜单 > 关于本机”查看。
• 管理员权限：部分安装可能需要管理员权限。
• 网络连接：需要联网下载安装包或工具。

安装方法

以下是三种常用的安装Node.js方法，按推荐顺序排列：

方法 1：使用Homebrew（推荐）

Homebrew 是Mac上常用的包管理器，安装简单且便于管理版本。

1. 安装Homebrew（若未安装）：

   • 打开终端（位于“应用程序 > 实用工具 > 终端”）。
   • 运行以下命令安装Homebrew：

     /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
     

   • 按提示输入密码并回车，安装过程可能需要几分钟。
   • 安装完成后，配置Homebrew环境变量（根据提示添加至 ~/.zshrc 或 ~/.bashrc）：

     echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
     source ~/.zshrc
     

2. 安装Node.js：

   • 在终端运行：

     brew install node
     

   • Homebrew会自动安装最新LTS版本的Node.js和npm。

3. 验证安装：

   • 检查Node.js版本：

     node --version
     

   • 检查npm版本：

     npm --version
     

   • 输出类似 v18.x.x（Node.js）和 9.x.x（npm）表示安装成功。

方法 2：直接从Node.js官网下载

适合不想使用包管理器的用户。

1. 访问Node.js官网：

   • 打开浏览器，前往 nodejs.org。
   • 推荐下载 LTS版本（长期支持版，稳定），点击“LTS”按钮下载 .pkg 安装包。

2. 运行安装包：

   • 双击下载的 .pkg 文件，启动安装向导。
   • 按提示点击“继续”，同意许可协议，选择安装位置（默认即可），输入管理员密码完成安装。
   • 安装程序会自动安装Node.js和npm。

3. 验证安装：

   • 打开终端，运行：

     node --version
     npm --version
     

   • 确认版本号输出。

方法 3：使用nvm（Node Version Manager）

适合需要管理多个Node.js版本的开发者。

1. 安装nvm：

   • 在终端运行以下命令安装nvm：

     curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
     

   • 安装完成后，关闭并重新打开终端，或运行：

     source ~/.zshrc
     

   • 验证nvm安装：

     nvm --version
     

2. 安装Node.js：

   • 安装最新LTS版本：

     nvm install --lts
     

   • 或指定版本，例如：

     nvm install 18
     

   • 设置默认版本：

     nvm use --lts
     nvm alias default --lts
     

3. 验证安装：

   • 检查Node.js和npm版本：

     node --version
     npm --version
     

注意事项

• 权限问题：
  • 若npm安装全局包时提示权限错误，避免使用 sudo。可修复npm权限：

    sudo 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 安装。
• 卸载Node.js（如需要）：
  • Homebrew：brew uninstall node。
  • 官网安装：手动删除 /usr/local/bin/node 和 /usr/local/lib/node_modules。
  • nvm：nvm uninstall <版本号>。
• 防火墙/代理：若下载缓慢，检查网络设置或使用国内镜像（如 https://npmmirror.com/mirrors/node/）。

问题排查

• 命令未找到：确保环境变量正确配置，检查 ~/.zshrc 或 ~/.bashrc 中的PATH设置。
• 安装失败：尝试更新Homebrew（brew update）或清理缓存（brew cleanup）。
• 版本冲突：使用nvm管理多个版本，避免冲突。
• 若需进一步帮助，请提供错误信息，我可协助排查。