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

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

Git
Node.js
Python
Rust
Docker

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

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

vbnet 复制代码

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

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

一、官方安装 Homebrew（推荐）

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

bash 复制代码

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

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

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

二、国内镜像安装 Homebrew

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

运行以下命令：

bash 复制代码

/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 出现：

bash 复制代码

command not found: brew

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

可以手动添加环境变量。

编辑配置文件：

bash 复制代码

vim ~/.zprofile

添加以下内容：

bash 复制代码

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

保存后执行：

bash 复制代码

source ~/.zprofile

重新打开终端即可。

五、Homebrew常用命令

安装软件：

复制代码

brew install git

更新软件源：

sql 复制代码

brew update

升级软件：

复制代码

brew upgrade

卸载软件：

复制代码

brew uninstall 软件名

六、总结

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

解决方法：

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

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

常见问题 FAQ

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

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

可以尝试：

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

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

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

如果执行：

复制代码

brew -v

提示：

bash 复制代码

command not found: brew

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

执行：

bash 复制代码

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

或者添加到：

bash 复制代码

~/.zprofile

然后执行：

bash 复制代码

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 默认安装路径为：

bash 复制代码

/opt/homebrew

而 Intel Mac 默认路径为：

bash 复制代码

/usr/local