【2026 最新】Mac 终端神器 Homebrew 完全指南:从安装、换源加速到核心命令速查(Mac 版)

Homebrew 是 macOS(以及 Linux)上一个极其流行的包管理工具。你可以把它形象地理解为一个"命令行应用商店"。

它的核心使命是解决在 macOS 上安装、更新和管理软件的繁琐问题,因此被誉为 "macOS 缺失的包管理器" (The missing package manager for macOS)

一、前言介绍

为什么需要 Homebrew?

在没有 Homebrew 的时代,在 macOS 上管理开发工具(如 Git, Python, Node.js)通常很麻烦:

  • 下载麻烦:需要去各个软件官网寻找安装包。
  • 依赖复杂:软件依赖的其他库需要手动安装和配置。
  • 管理困难:升级和卸载软件容易残留文件,难以追踪。

Homebrew 彻底改变了这一现状,通过简单的命令(如 brew install git)就能自动完成下载、解决依赖、编译安装和路径配置,极大地提升了开发者效率。

二、核心概念

Homebrew 的设计非常直观,主要包含以下几个核心概念:

  • Formula (公式) :用于安装命令行工具和库。例如,通过 brew install python 安装 Python 环境。
  • Cask (桶) :用于安装带有图形界面(GUI)的 macOS 应用程序。例如,通过 brew install --cask visual-studio-code 安装 VS Code。
  • Tap (第三方仓库):一个扩展机制,允许你添加第三方软件源,获取更多官方仓库没有的软件。

三、下载安装

官网:https://brew.sh/zh-cn/

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

上述指令是下载位于 GitHub 上的安装脚本。

如果不能正常下载或者下载缓慢,使用下述的国内清华源安装脚本:

bash 复制代码
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

键盘 command + 空格 进入搜索 搜索 终端并打开,接着粘贴上述指令。

输入指令后会出现 Password 字样直接输入你的电脑密码点击回车,便会自动下载。

出现下述 下载 XCode 字样,继续回车即可。

四、验证安装

bash 复制代码
brew --version

出现版本号即安装成功:

五、切换国内镜像

由于 Homebrew 的软件源位于 GitHub,国内用户直接使用可能会遇到下载缓慢或失败的问题。强烈建议更换为国内镜像源,这能显著提升安装速度和成功率。

输入下述指令可以查看当前源:

bash 复制代码
git -C "$(brew --repo)" remote -v

我的源是github:

这里我推荐清华源,切换镜像源示例 (以清华大学源为例),切换镜像源的本质是修改其背后 Git 仓库的远程地址。

打开终端配置文件

macOS 默认使用 zsh,因此我们需要编辑 ~/.zshrc 文件。

复制代码
nano ~/.zshrc

添加清华源配置

在文件末尾添加以下三行配置:

复制代码
# 设置 Homebrew 核心仓库、API 和二进制包的镜像源为清华大学镜像站
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"
export HOMEBREW_API_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api"
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles"

使配置立即生效

保存并退出编辑器(在 nano 中按 Ctrl + O 保存,然后 Ctrl + X 退出),然后执行以下命令让配置生效:

复制代码
source ~/.zshrc

更新 Homebrew

最后,运行 brew update 来应用新的源配置。首次更新可能会稍慢,因为它需要从新源拉取数据。

复制代码
brew update

再次查看源就可以发现更改成功

bash 复制代码
git -C "$(brew --repo)" remote -v

六、常用指令

掌握了这些常用命令,你就能像专家一样高效管理 macOS 上的软件了。

以下是最核心、最常用的 Homebrew 命令速查表,涵盖了日常使用的方方面面:

6.1 核心常用命令速查表

操作类别 命令格式 说明
安装 brew install <软件名> 安装命令行工具(如 git, wget
安装 GUI brew install --cask <软件名> 安装图形界面应用(如 visual-studio-code
搜索 brew search <关键词> 搜索可用的软件包
更新 brew update 更新 Homebrew 自身及软件列表
升级 brew upgrade 升级 所有已安装的软件到最新版
卸载 brew uninstall <软件名> 卸载指定软件
列表 brew list 查看已安装的软件列表
信息 brew info <软件名> 查看软件的详细信息(版本、依赖等)
诊断 brew doctor 检查系统环境是否存在问题(排错神器)

6.2 详细命令分类解析

6.2.1 搜索与发现 (search, info)

在安装之前,通常需要先确认软件是否存在或查看其详情。

  • 搜索软件

    复制代码
    brew search google
    brew search python
  • 查看软件信息

    复制代码
    brew info git

    输出会显示:当前版本、是否已安装、依赖关系、安装路径等。

6.2.2 安装与卸载 (install, uninstall)

这是最常用的功能。Homebrew 分为 Formula (命令行工具)和 Cask(图形界面应用)。

  • 安装命令行工具 (Formula):

    复制代码
    brew install wget
    brew install node@18  # 安装指定版本
  • 安装图形界面应用 (Cask):

    复制代码
    brew install --cask google-chrome
    brew install --cask visual-studio-code
  • 卸载软件

    复制代码
    brew uninstall wget
    brew uninstall --cask google-chrome  # 卸载图形应用需带上 --cask
6.2.3 更新与升级 (update, upgrade)

新手容易混淆这两个概念,记住这个口诀:

  • update :去应用商店刷新货架(更新软件列表)。

  • upgrade :把家里已有的旧东西换成新东西(升级已安装软件)。

  • 更新软件列表

    复制代码
    brew update
  • 升级所有软件

    复制代码
    brew upgrade
  • 升级指定软件

    复制代码
    brew upgrade git
6.2.4 状态与清理 (list, cleanup, outdated)

保持系统整洁。

  • 列出已安装软件

    复制代码
    brew list          # 列出命令行工具
    brew list --cask   # 仅列出图形界面应用
  • 查看可升级的软件

    复制代码
    brew outdated
  • 清理缓存 (释放磁盘空间):

    复制代码
    brew cleanup

    这会删除旧版本的安装包和缓存文件。

6.2.5 诊断与帮助 (doctor, help)
  • 诊断环境问题

    复制代码
    brew doctor

    如果遇到安装报错,先运行这个命令,它会给出非常具体的修复建议。

  • 查看帮助

    复制代码
    brew help
    brew help install  # 查看 install 命令的详细用法
6.2.5 进阶小贴士
  • 锁定版本 :如果你不希望某个软件在 upgrade 时被更新,可以将其锁定:

    复制代码
    brew pin git  # 锁定 git
    brew unpin git # 解锁
  • 查看依赖树

    复制代码
    brew deps --installed --tree

    查看已安装软件的依赖关系,非常直观。