跳到主要内容
极客日志极客日志
首页博客AI提示词GitHub精选代理工具
搜索
|注册
博客列表
Shell / Bash大前端

Homebrew 完全指南:从安装、换源加速到核心命令速查

Homebrew 是 macOS 上流行的包管理工具,用于简化命令行工具和图形应用的安装与管理。内容涵盖安装步骤、国内镜像源切换方法及常用命令速查,帮助开发者高效配置开发环境。

晚风叙旧发布于 2026/3/26更新于 2026/5/1219 浏览
Homebrew 完全指南:从安装、换源加速到核心命令速查

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/

文章配图

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

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

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

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

通过 Spotlight 搜索'终端'并打开,接着粘贴上述指令。

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

文章配图

系统会提示需要安装 Xcode Command Line Tools,继续回车即可。

文章配图

文章配图

验证安装

brew --version 

显示版本号即安装成功:

文章配图

切换国内镜像

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

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

git -C "$(brew --repo)" remote -v

默认源为 GitHub。

推荐使用清华大学镜像源,切换镜像源示例如下,切换镜像源的本质是修改其背后 Git 仓库的远程地址。

替换主仓库

  • 替换 brew.git 仓库
git -C "$(brew --repo)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git

文章配图

接着更新:

brew update

文章配图

可选替代

下述需要你已经用 homebrew 下载安装过软件后,才可以执行,不然会出现文件不存在的情况:No such file or directory。

为什么会出现这种情况?

  • Tap 机制:Homebrew 将软件分成了不同的'桶'(Taps)。
    • homebrew/cask:管理图形界面软件(你之前可能用过,所以它存在)。
    • homebrew/core:管理命令行工具(你没用过,所以它被'懒加载'了)。
  • Update 的逻辑:brew update 默认只更新已经安装(Initialized)的 Taps。因为 core 还没被初始化,所以 update 跳过了它。

所以需要你之后下载过必要软件之后再来执行下述命令,可以替换镜像源。

  • 替换 homebrew-core 仓库
git -C "$(brew --repo homebrew/core)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git
  • 替换 homebrew-cask 仓库 (用于图形应用)
git -C "$(brew --repo homebrew/cask)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-cask.git

常用指令

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

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

核心常用命令速查表

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

详细命令分类解析

搜索与发现 (search, info)

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

查看软件信息:

brew info git 

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

搜索软件:

brew search google
brew search python 
安装与卸载 (install, uninstall)

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

卸载软件:

brew uninstall wget
brew uninstall --cask google-chrome # 卸载图形应用需带上 --cask 

安装图形界面应用 (Cask):

brew install --cask google-chrome
brew install --cask visual-studio-code 

安装命令行工具 (Formula):

brew install wget
brew install node@18 # 安装指定版本 
更新与升级 (update, upgrade)

注意区分以下两个概念:

  • update:去应用商店刷新货架(更新软件列表)。
  • upgrade:把家里已有的旧东西换成新东西(升级已安装软件)。

升级指定软件:

brew upgrade git 

升级所有软件:

brew upgrade 

更新软件列表:

brew update 
状态与清理 (list, cleanup, outdated)

保持系统整洁。

清理缓存(释放磁盘空间):

brew cleanup 

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

查看可升级的软件:

brew outdated 

列出已安装软件:

brew list # 列出命令行工具
brew list --cask # 仅列出图形界面应用 
诊断与帮助 (doctor, help)

查看帮助:

brew help
brew help install # 查看 install 命令的详细用法 

诊断环境问题:

brew doctor 

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

进阶小贴士

查看依赖树:

brew deps --installed --tree 

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

锁定版本:如果你不希望某个软件在 upgrade 时被更新,可以将其锁定:

brew pin git # 锁定 git
brew unpin git # 解锁 

目录

  1. 前言介绍
  2. 为什么需要 Homebrew?
  3. 核心概念
  4. 下载安装
  5. 验证安装
  6. 切换国内镜像
  7. 替换主仓库
  8. 可选替代
  9. 常用指令
  10. 核心常用命令速查表
  11. 详细命令分类解析
  12. 搜索与发现 (search, info)
  13. 安装与卸载 (install, uninstall)
  14. 更新与升级 (update, upgrade)
  15. 状态与清理 (list, cleanup, outdated)
  16. 诊断与帮助 (doctor, help)
  17. 进阶小贴士
  • 💰 8折买阿里云服务器限时8折了解详情
  • GPT-5.5 超高智商模型1元抵1刀ChatGPT中转购买
  • 代充Chatgpt Plus/pro 帐号了解详情
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • 人工智能:自然语言处理在金融领域的应用与实战
  • Python 异步爬虫与 K8S 弹性伸缩:构建高并发数据采集引擎
  • Python 爬虫实战:爬取 BOSS 直聘与智联招聘岗位信息
  • Claude Agent Skills 工具箱:7 大开源项目解析与实战指南
  • AI Agent 落地实战:9 步全流程搭建指南
  • FAIR plus 机器人全产业链接会:聚焦具身智能与全球协作
  • 后仿真 SDF 反标常见 Warning 分析与处理指南
  • 算法实战:位运算解决整数求和与缺失数字问题
  • 大语言模型微调概念解析与实战流程指南
  • Spring AI 框架完整指南
  • Linux 命名管道(FIFO)通信:原理与跨进程实现实战
  • 麦橘超然 Flux 本地部署与低显存优化实战
  • AcousticSense AI 多场景:ASR 文本 + 音频频谱双模态流派推断
  • 飞算 Java AI 编程助手功能介绍与实践
  • AIGC 时代 Kubernetes 企业级云原生运维实战
  • 配置 Obsidian Git 插件实现本地笔记同步至 GitHub 仓库 (Mac)
  • DeepSeek-R1 大模型基于 MS-Swift 框架的部署、推理与微调实践
  • FAIR plus 机器人全产业链接会及 2026 展会信息
  • C++ string 类详解:初始化、遍历与常用成员函数
  • C++ OpenCV 入门实战指南(Ubuntu 24.04)

相关免费在线工具

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online

  • JSON美化和格式化

    将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online