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
相关推荐
oil欧哟1 天前
Oil Studio 的产品思路与日常使用方式:在 Mac 上录口播演示,并接入 AI Agent 精剪与自动录屏
人工智能·macos
小毛球.3 天前
第 3 篇:IDEA 最新版下载与完整安装教程(Mac)
java·macos·intellij-idea·idea
CodeClimb4 天前
Mac 磁盘无法推出(DMG外接盘)排查处理教程
macos
Karl_fang5 天前
🥳 再也不用拿起手机抄验证码!我做了一个 Android → Mac 的「验证码接力」工具
前端·macos·ai编程
csdn_aspnet6 天前
macOS 10 、Docker 玩轉 MySQL
运维·mysql·macos·docker·容器·mac
秋雨梧桐叶落莳6 天前
【iOS】Block底层详解
macos·ios·cocoa
高调的涵涵8 天前
café 和 café 不是一个文件名
macos
独隅10 天前
WebStorm macOS 安装部署与高效调优完全指南
ide·macos·webstorm
独隅11 天前
WebStorm macOS 安装调优与实战效能全景
ide·macos·webstorm
2601_9679873711 天前
安装 Redis 或 Redis Stack
linux·windows·redis·macos·安装