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