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 是否安装成功
--------------------

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

```null
brew -v

```

如果显示类似：

```null
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常用命令
--------------

安装软件：

```null
brew install git

```

更新软件源：

```sql
brew update

```

升级软件：

```null
brew upgrade

```

卸载软件：

```null
brew uninstall 软件名

```

* * *

六、总结
----

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

解决方法：

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

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

* * *

常见问题 FAQ
--------

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

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

可以尝试：

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

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

* * *

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

如果执行：

```null
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

```