Homebrew 是 macOS 上最常用的包管理工具,可以帮助开发者快速安装各种软件,例如:
Git
Node.js
Python
Rust
Docker
通过 Homebrew,你只需要一条命令就可以安装软件,非常方便。
不过在国内网络环境下,安装 Homebrew 时经常会出现连接 GitHub 失败的问题:
curl: (7) Failed to connect to raw.githubusercontent.com port 443 本文将介绍 Mac安装Homebrew的完整教程,并提供 国内镜像安装方法 来解决安装失败的问题。
Homebrew 官方提供了安装脚本,可以通过以下命令安装:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" 执行后系统会自动下载 Homebrew 并完成安装。
如果你的网络环境可以正常访问 GitHub,那么这种方式是最简单的。
如果安装过程中出现 GitHub 连接失败,可以使用国内镜像安装。
运行以下命令:
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)" 该脚本会自动:
下载 Homebrew
配置国内镜像
设置环境变量
适合国内网络环境使用。
安装完成后,在终端执行:
brew -v 如果显示类似:
Homebrew 4.x.x 说明 Homebrew 已经安装成功。
如果执行 brew -v 出现:
command not found: brew 通常是因为环境变量没有配置成功。
可以手动添加环境变量。
编辑配置文件:
vim ~/.zprofile 添加以下内容:
export PATH="/opt/homebrew/bin:$PATH" 保存后执行:
source ~/.zprofile 重新打开终端即可。
安装软件:
brew install git 更新软件源:
brew update 升级软件:
brew upgrade 卸载软件:
brew uninstall 软件名 在 Mac 上安装 Homebrew 时,常见问题主要是 网络访问 GitHub 失败。
解决方法:
优先使用官方安装脚本
如果无法访问 GitHub,可以使用国内镜像安装
安装完成后检查环境变量
配置完成后,就可以使用 Homebrew 安装各种开发工具。
如果安装 Homebrew 时出现 GitHub 连接失败,通常是网络问题导致的。
可以尝试:
使用国内镜像安装
更换网络环境后重新安装
稍后再次尝试
一般情况下使用国内镜像即可解决问题。
如果执行:
brew -v 提示:
command not found: brew 说明环境变量没有配置成功。
执行:
export PATH="/opt/homebrew/bin:$PATH" 或者添加到:
~/.zprofile 然后执行:
source ~/.zprofile 如果使用 Homebrew 安装软件速度很慢,可以考虑使用国内镜像源,例如:
清华大学镜像
中科大镜像
更换镜像后下载速度会明显提升。
Homebrew 是 macOS 上最流行的包管理工具,可以用来安装各种开发软件,例如:
Git
Node.js
Python
Rust
Docker
通过 Homebrew,可以用一条命令快速安装软件。
支持,但是macOS26版本可能出现官方无法正确识别问题。
在 Apple Silicon Mac 上,Homebrew 默认安装路径为:
/opt/homebrew 而 Intel Mac 默认路径为:
/usr/local