---
url: https://eoht.net/fe/homebrew/install.md
description: >-
  使用官方脚本安装 Homebrew，配置 Apple Silicon、Intel Mac 和 Linux 的 shellenv，检查安装结果，并使用
  Brewfile 迁移软件清单。
---

# Homebrew 安装教程：macOS、Linux 与环境配置 {#homebrew-introduction-and-installation}

## 简介 {#homebrew-overview}

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

## 安装 Homebrew {#install-homebrew}

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

在终端执行[官方安装入口](https://brew.sh/)：

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

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

::: code-group

```sh [Apple Silicon Mac]
eval "$(/opt/homebrew/bin/brew shellenv)"
```

```sh [Intel Mac]
eval "$(/usr/local/bin/brew shellenv)"
```

```sh [Linux]
eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"
```

:::

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

## 检查 Homebrew 环境 {#check-homebrew-environment}

```sh
command -v brew
brew --version
brew --prefix
brew doctor
```

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

## 更新 Homebrew {#update-homebrew}

```sh
brew update
brew outdated
```

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

## 使用 Brewfile 完成环境迁移 {#migrate-homebrew-environment-with-brewfile}

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

```sh
brew bundle dump
```

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

```sh
brew bundle
brew bundle check
```

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

参考：[Homebrew 安装文档](https://docs.brew.sh/Installation)、[Homebrew Bundle](https://docs.brew.sh/Brew-Bundle-and-Brewfile)。