Mac安装Homebrew教程:解决brew安装失败(国内镜像安装方法)
lixunlixun
2026年03月05日 02:53
收录于文集
共2篇

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

  • Git

  • Node.js

  • Python

  • Rust

  • Docker

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

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

代码块
PlainText
自动换行
复制代码
curl: (7) Failed to connect to raw.githubusercontent.com port 443
复制成功

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


一、官方安装 Homebrew(推荐)

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

代码块
PlainText
自动换行
复制代码
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
复制成功

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

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


二、国内镜像安装 Homebrew

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

运行以下命令:

代码块
PlainText
自动换行
复制代码
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
复制成功

该脚本会自动:

  • 下载 Homebrew

  • 配置国内镜像

  • 设置环境变量

适合国内网络环境使用。


三、验证 Homebrew 是否安装成功

安装完成后,在终端执行:

代码块
PlainText
自动换行
复制代码
brew -v
复制成功

如果显示类似:

代码块
PlainText
自动换行
复制代码
Homebrew 4.x.x
复制成功

说明 Homebrew 已经安装成功。


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

如果执行 brew -v 出现:

代码块
PlainText
自动换行
复制代码
command not found: brew
复制成功

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

可以手动添加环境变量。

编辑配置文件:

代码块
PlainText
自动换行
复制代码
vim ~/.zprofile
复制成功

添加以下内容:

代码块
PlainText
自动换行
复制代码
export PATH="/opt/homebrew/bin:$PATH"
复制成功

保存后执行:

代码块
PlainText
自动换行
复制代码
source ~/.zprofile
复制成功

重新打开终端即可。


五、Homebrew常用命令

安装软件:

代码块
PlainText
自动换行
复制代码
brew install git
复制成功

更新软件源:

代码块
PlainText
自动换行
复制代码
brew update
复制成功

升级软件:

代码块
PlainText
自动换行
复制代码
brew upgrade
复制成功

卸载软件:

代码块
PlainText
自动换行
复制代码
brew uninstall 软件名
复制成功

六、总结

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

解决方法:

  1. 优先使用官方安装脚本

  2. 如果无法访问 GitHub,可以使用国内镜像安装

  3. 安装完成后检查环境变量

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


常见问题 FAQ

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

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

可以尝试:

  • 使用国内镜像安装

  • 更换网络环境后重新安装

  • 稍后再次尝试

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


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

如果执行:

代码块
PlainText
自动换行
复制代码
brew -v
复制成功

提示:

代码块
PlainText
自动换行
复制代码
command not found: brew
复制成功

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

执行:

代码块
PlainText
自动换行
复制代码
export PATH="/opt/homebrew/bin:$PATH"
复制成功

或者添加到:

代码块
PlainText
自动换行
复制代码
~/.zprofile
复制成功

然后执行:

代码块
PlainText
自动换行
复制代码
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 默认安装路径为:

代码块
Shell
自动换行
复制代码
/opt/homebrew
复制成功

而 Intel Mac 默认路径为:

代码块
PlainText
自动换行
复制代码
/usr/local
复制成功

#Mac#​#Homebrew#​#开发环境#​#Mac教程#​