🍺 Homebrew

✨ Mac 上最好用的包管理工具之一。适合安装命令行工具、GUI 应用、后台服务，也很适合新电脑初始化。

🧠 它是什么

Homebrew 可以理解成 macOS 上的“应用商店 + 命令行安装器”。

它最常见的用途：

  • 安装命令行工具，比如 git、wget、node
  • 安装图形应用，比如 google-chrome、visual-studio-code
  • 管理后台服务，比如 mysql、redis
  • 统一软件的安装、升级、卸载和清理

一句话理解：

💡 不想手动找官网、下载、拖进应用目录时，很多东西都可以先看看能不能 brew install。

💻 安装 Homebrew

官方首页：

1. 🧰 安装 Xcode Command Line Tools

Homebrew 在 macOS 上通常需要先准备好 Command Line Tools：

1
xcode-select --install

如果系统提示已经安装过，就可以继续下一步。

2. 🚀 安装 Homebrew

  • 官方安装命令：
1
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  • 国内镜像安装命令：
1
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

3. ✅ 检查是否安装成功

1
brew --version

如果能正常显示版本号，说明安装成功。

🧭 安装后的路径概念

Homebrew 官方推荐的默认安装位置：

  • Apple Silicon Mac：/opt/homebrew
  • Intel Mac：/usr/local

这是官方支持的默认前缀，很多二进制包也依赖这个位置。

📌 也就是说，M1 / M2 / M3 之类机器上看到 /opt/homebrew 很正常。

⚙️ 如果安装后提示 brew 命令不存在

有时候安装完成后，当前 shell 还没加载 Homebrew 环境。

Apple Silicon 常见写法

1
eval "$(/opt/homebrew/bin/brew shellenv)"

Intel Mac 常见写法

1
eval "$(/usr/local/bin/brew shellenv)"

如果想长期生效，可以把对应命令写进你的 shell 配置文件，比如：

  • ~/.zprofile
  • ~/.zshrc

检查：

1
2
which brew
brew --version

📦 Homebrew 安装什么

Homebrew 里你会经常遇到 3 类东西：

1. 🧱 Formula

命令行工具和库，通常这样装：

1
2
3
brew install git
brew install node
brew install wget

2. 🪟 Cask

图形界面应用，通常这样装：

1
2
3
brew install --cask google-chrome
brew install --cask visual-studio-code
brew install --cask iterm2

3. 🔁 Services

后台服务，比如数据库、缓存、队列：

1
2
3
4
brew install mysql
brew install redis
brew services start mysql
brew services start redis

🚀 最常用命令

🔍 搜索软件

1
brew search 关键词

示例：

1
2
3
brew search git
brew search python
brew search chrome

📥 安装

安装命令行工具：

1
brew install 包名

安装 GUI 应用：

1
brew install --cask 应用名

示例：

1
2
3
brew install git
brew install python
brew install --cask visual-studio-code

📋 查看已安装内容

1
2
brew list
brew list --cask

ℹ️ 查看软件信息

1
brew info 包名

示例：

1
2
brew info git
brew info node

🗑️ 卸载

卸载命令行工具：

1
brew uninstall 包名

卸载 GUI 应用：

1
brew uninstall --cask 应用名

示例：

1
2
brew uninstall git
brew uninstall --cask google-chrome

🔄 更新与升级

更新 Homebrew 本身和软件索引

1
brew update

查看哪些软件可升级

1
brew outdated

升级所有已安装软件

1
brew upgrade

升级单个软件

1
brew upgrade 包名

示例：

1
2
brew upgrade git
brew upgrade node

💡 官方 FAQ 提到：brew upgrade 后，Homebrew 会自动清理旧版本，并且还会定期做额外清理。

🧹 清理与体检

清理旧版本和缓存

1
brew cleanup

检查当前环境是否有问题

1
brew doctor

查看 Homebrew 配置

1
brew config

这三个命令很适合排错时一起用。

🔁 服务管理

如果你用 Homebrew 安装了服务类软件，比如 mysql、postgresql、redis，常用命令是：

启动服务

1
brew services start 服务名

停止服务

1
brew services stop 服务名

重启服务

1
brew services restart 服务名

查看服务状态

1
brew services list

示例：

1
2
3
brew services start redis
brew services restart mysql
brew services list

🧰 常见安装示例

开发常用工具

1
2
3
4
5
brew install git
brew install node
brew install python
brew install wget
brew install pnpm

常见 GUI 应用

1
2
3
4
brew install --cask visual-studio-code
brew install --cask google-chrome
brew install --cask iterm2
brew install --cask docker

常见服务

1
2
3
brew install mysql
brew install redis
brew install postgresql

⚡ 高频命令速查

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
brew --version
brew search 关键词
brew install 包名
brew install --cask 应用名
brew list
brew list --cask
brew info 包名
brew update
brew outdated
brew upgrade
brew upgrade 包名
brew uninstall 包名
brew uninstall --cask 应用名
brew cleanup
brew doctor
brew config
brew services list
brew services start 服务名
brew services stop 服务名
brew services restart 服务名

🩹 常见问题

❌ brew: command not found

先试：

1
2
which brew
brew --version

如果不行，通常是 shell 环境没加载。

Apple Silicon：

1
eval "$(/opt/homebrew/bin/brew shellenv)"

Intel：

1
eval "$(/usr/local/bin/brew shellenv)"

然后把对应命令写进：

1
~/.zprofile

或：

1
~/.zshrc

❌ 安装很慢

常见原因：

  • 网络慢
  • 下载源码而不是二进制包
  • 当前软件依赖较多

先确认 Homebrew 当前状态：

1
2
3
brew update
brew doctor
brew config

❌ brew doctor 提示异常

先别慌，brew doctor 有时会给出一些“建议修复项”。

处理思路：

  1. 先读清楚提示内容
  2. 只处理和当前问题相关的项
  3. 改完再重新运行：
1
brew doctor

❌ 服务起不来

先看服务列表：

1
brew services list

再看软件信息：

1
brew info 服务名

必要时尝试重启：

1
brew services restart 服务名

🎯 我的推荐使用习惯

日常可以这样用：

安装新工具

1
2
brew search 关键词
brew install 包名

每隔一段时间更新

1
2
3
brew update
brew upgrade
brew cleanup

遇到问题先体检

1
2
brew doctor
brew config

这套就已经很够用了。

🚀 新 Mac 初始化时的常用顺序

如果是新电脑，我一般会按这个顺序来：

  1. 安装 Xcode Command Line Tools
  2. 安装 Homebrew
  3. 配好 brew shellenv
  4. 检查 brew --version
  5. 安装开发工具
  6. 安装 GUI 应用
  7. 按需启动服务

命令流：

1
2
3
4
5
6
xcode-select --install
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
eval "$(/opt/homebrew/bin/brew shellenv)"
brew --version
brew install git node python
brew install --cask visual-studio-code iterm2

📌 如果是 Intel Mac，把 shellenv 路径替换成 /usr/local/bin/brew。

🔗 官方参考

🪄 超短版

只记住这些就已经能覆盖大多数日常场景：

1
2
3
4
5
6
7
8
brew install 包名
brew install --cask 应用名
brew list
brew update
brew upgrade
brew cleanup
brew doctor
brew services list