Homebrew 安装教程：macOS、Linux 与环境配置

简介

Homebrew 是社区维护的开源包管理器，可在 macOS 和 Linux 上安装、更新和卸载软件；它不是 Apple 官方开发的工具。命令行软件通常以 formula 提供，macOS 图形应用和字体通常通过 cask 安装。

安装 Homebrew

适用于受 Homebrew 支持的 macOS / Linux 环境。macOS 需要 Xcode Command Line Tools；Linux 的编译工具与系统要求见官方安装文档。已有 Homebrew 时先执行 brew --version，不必重复安装。

在终端执行官方安装入口：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

阅读脚本提示后确认安装。完成后按终端的 Next steps 配置 PATH；默认前缀通常如下，选择与本机匹配的一项：

Apple Silicon Mac

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

Intel Mac

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

Linux

eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"

上述命令只加载当前终端。将对应的 eval 整行加入安装器建议的启动文件，例如 macOS 默认 zsh 的 ~/.zprofile；自定义安装路径以实际输出为准。不要把三项同时加入。

检查 Homebrew 环境

command -v brew
brew --version
brew --prefix
brew doctor

前两项用于确认命令可用和版本，brew --prefix 显示安装位置。brew doctor 给出诊断建议；如有警告，应按具体内容处理，不能仅凭命令能运行就视为全部正常。

更新 Homebrew

brew update
brew outdated

brew update 更新 Homebrew 和软件元数据；已安装软件的升级由 brew upgrade 执行。升级前先用 brew outdated 查看受影响的软件。

使用 Brewfile 完成环境迁移

在旧设备的工作目录导出软件清单：

brew bundle dump

将生成的 Brewfile 复制到新设备，在该文件所在目录执行：

brew bundle
brew bundle check

Brewfile 记录安装清单，不是软件数据或配置文件的备份；新设备的系统和架构也可能影响软件可用性。已有 Brewfile 时先检查内容，避免覆盖手工维护的清单。

参考：Homebrew 安装文档、Homebrew Bundle。