267 lines
4.0 KiB
Markdown
267 lines
4.0 KiB
Markdown
|
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
|
|||
|
|
|
|||
|
|
```
|