Mac安装Homebrew教程：解决brew安装失败（国内镜像安装方法）

Homebrew 是 macOS 上最常用的包管理工具，可以帮助开发者快速安装各种软件，例如：

• Git
• Node.js
• Python
• Rust
• Docker

通过 Homebrew，你只需要一条命令就可以安装软件，非常方便。

不过在国内网络环境下，安装 Homebrew 时经常会出现连接 GitHub 失败的问题：

curl: (7) Failed to connect to raw.githubusercontent.com port 443

本文将介绍 Mac安装Homebrew的完整教程，并提供 国内镜像安装方法 来解决安装失败的问题。

一、官方安装 Homebrew（推荐）

Homebrew 官方提供了安装脚本，可以通过以下命令安装：

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

执行后系统会自动下载 Homebrew 并完成安装。

如果你的网络环境可以正常访问 GitHub，那么这种方式是最简单的。

二、国内镜像安装 Homebrew

如果安装过程中出现 GitHub 连接失败，可以使用国内镜像安装。

运行以下命令：

/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

该脚本会自动：

• 下载 Homebrew
• 配置国内镜像
• 设置环境变量

适合国内网络环境使用。

三、验证 Homebrew 是否安装成功

安装完成后，在终端执行：

brew -v

如果显示类似：

Homebrew 4.x.x

说明 Homebrew 已经安装成功。

四、brew命令无法使用的解决方法

如果执行 brew -v 出现：

command not found: brew

通常是因为环境变量没有配置成功。

可以手动添加环境变量。

编辑配置文件：

vim ~/.zprofile

添加以下内容：

export PATH="/opt/homebrew/bin:$PATH"

保存后执行：

source ~/.zprofile

重新打开终端即可。

五、Homebrew常用命令

安装软件：

brew install git

更新软件源：

brew update

升级软件：

brew upgrade

卸载软件：

brew uninstall 软件名

六、总结

在 Mac 上安装 Homebrew 时，常见问题主要是 网络访问 GitHub 失败。

解决方法：

1. 优先使用官方安装脚本
2. 如果无法访问 GitHub，可以使用国内镜像安装
3. 安装完成后检查环境变量

配置完成后，就可以使用 Homebrew 安装各种开发工具。

常见问题 FAQ

1、Mac安装Homebrew失败怎么办？

如果安装 Homebrew 时出现 GitHub 连接失败，通常是网络问题导致的。

可以尝试：

• 使用国内镜像安装
• 更换网络环境后重新安装
• 稍后再次尝试

一般情况下使用国内镜像即可解决问题。

2、brew安装完成后提示命令不存在怎么办？

如果执行：

brew -v

提示：

command not found: brew

说明环境变量没有配置成功。

执行：

export PATH="/opt/homebrew/bin:$PATH"

或者添加到：

~/.zprofile

然后执行：

source ~/.zprofile

3、Homebrew安装软件很慢怎么办？

如果使用 Homebrew 安装软件速度很慢，可以考虑使用国内镜像源，例如：

• 清华大学镜像
• 中科大镜像

更换镜像后下载速度会明显提升。

4、Homebrew 是做什么用的？

Homebrew 是 macOS 上最流行的包管理工具，可以用来安装各种开发软件，例如：

• Git
• Node.js
• Python
• Rust
• Docker

通过 Homebrew，可以用一条命令快速安装软件。

5、Homebrew 是否支持 Apple Silicon（M芯片）？

支持，但是macOS26版本可能出现官方无法正确识别问题。

在 Apple Silicon Mac 上，Homebrew 默认安装路径为：

/opt/homebrew

而 Intel Mac 默认路径为：

/usr/local