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 失败

解决方法:

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

配置完成后,就可以使用 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
相关推荐
前端嘣擦擦2 小时前
mac 安装 nvm + node + npm(国内镜像 + 官方安装步骤)
前端·macos·npm
小江的记录本3 小时前
【MacOS】MacBook Pro 键盘全解析 + macOS 快捷键大全
java·经验分享·学习·macos·计算机外设·键盘·敏捷开发
芥子沫3 小时前
Mac上最好用的软件都有哪些呢?
macos·软件推荐
云攀登者-望正茂4 小时前
macOS上Docker使用systemd cgroup驱动失败原因
macos·docker
Jackson@ML4 小时前
2026最新版Anaconda Navigator for Mac安装使用指南
python·macos·anaconda
聪明人17 小时前
macOS安装Redis
数据库·redis·macos
九天轩辕1 天前
跨平台符号表生成规则详解:Windows/Linux/macOS/OHOS
linux·windows·macos
阿捏利1 天前
详解Mach-O(三十三)Mach-O __mod_term_func节
macos·ios·c/c++·mach-o
零千叶1 天前
养龙虾,本地部署OpenClaw
人工智能·macos·openclaw