Mac上安装Homebrew的详细步骤

本教程适用于macOS 10.15（Catalina）及以上版本。

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

前提条件

• 操作系统：macOS 10.15或更高版本（检查：苹果菜单 > 关于本机）。
• 管理员权限：安装需要管理员权限。
• 网络连接：需联网下载安装脚本和依赖。
• Xcode命令行工具：Homebrew依赖部分Xcode工具，安装时会自动提示。

安装步骤

1. 打开终端：

   • 打开“应用程序 > 实用工具 > 终端”。

2. 运行Homebrew安装命令：

   • 在终端粘贴以下命令并按回车：

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

   • 命令说明：
     • curl 下载Homebrew安装脚本。
     • /bin/bash 执行脚本开始安装。

3. 按提示操作：

   • 安装过程中可能提示输入管理员密码，输入后按回车。
   • 系统可能提示安装Xcode命令行工具，输入以下命令自动安装：

     xcode-select --install
     

     • 弹出窗口后，点击“安装”并等待完成。
   • 继续按提示按回车，安装通常需要几分钟，视网络速度而定。

4. 配置环境变量：

   • 安装完成后，脚本会提示添加Homebrew到PATH。运行以下命令（根据你的终端Shell，可能为 zsh 或 bash）：

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

     • 如果使用bash，替换 ~/.zshrc 为 ~/.bashrc。
   • 这将确保 brew 命令在终端中可用。

5. 验证安装：

   • 检查Homebrew版本：

     brew --version
     

     • 输出类似 Homebrew 4.x.x 表示安装成功。
   • 运行诊断命令确认环境：

     brew doctor
     

     • 若提示“Warning: Your system is ready to brew”，表示配置正常。

注意事项

• 权限问题：
  • 安装可能需要sudo权限，确保输入正确的管理员密码。
  • 若提示权限错误，检查用户是否具有管理员权限（系统设置 > 用户与群组）。
• 网络问题：
  • 若下载缓慢，可尝试切换网络或使用国内镜像：

    export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"
    /bin/bash -c "$(curl -fsSL https://mirrors.tuna.tsinghua.edu.cn/homebrew/install/HEAD/install.sh)"
    

• 更新Homebrew：
  • 安装后，定期更新Homebrew：

    brew update
    

• 卸载Homebrew（如需要）：
  • 运行以下命令卸载：

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

问题排查

• 命令未找到：确保 source ~/.zshrc 已执行，或重启终端。
• 安装失败：检查网络连接，或查看终端错误日志。常见问题可能是Xcode工具缺失，重新运行 xcode-select --install。
• 旧版本macOS：若系统低于10.15，可能需要手动下载旧版Homebrew，参考 Homebrew官网。
• 若遇到具体错误，请提供错误信息，我可进一步协助。