跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / BashNode.js大前端

macOS Homebrew 完全指南:安装、换源与核心命令速查

综述由AI生成macOS 平台下流行的包管理工具 Homebrew。内容涵盖 Homebrew 的核心概念(Formula、Cask、Tap),提供了官方及国内镜像源的下载安装方法,并详细说明了如何切换清华源以加速下载。此外,文章整理了常用命令速查表,包括安装、搜索、更新、升级、卸载、诊断等功能,帮助开发者高效管理开发环境。

GitMaster发布于 2026/3/27更新于 2026/5/2328 浏览
macOS Homebrew 完全指南:安装、换源与核心命令速查

macOS Homebrew 完全指南

Homebrew 是 macOS(以及 Linux)上一个极其流行的包管理工具,可以形象地理解为一个'命令行应用商店'。它的核心使命是解决在 macOS 上安装、更新和管理软件的繁琐问题,被誉为'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)"

打开终端并粘贴上述指令。输入指令后会出现 Password 字样,直接输入电脑密码点击回车,便会自动下载。

出现提示要求下载 XCode 时,继续回车即可。

四、验证安装

brew --version

出现版本号即安装成功。

五、切换国内镜像

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

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

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

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

5.1 替换主仓库

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

接着更新:

brew update

5.2 可选替代

下述操作需要你已经用 Homebrew 下载安装过软件后才可以执行,不然会出现文件不存在的情况。

为什么会出现这种情况?

  • 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 命令速查表,涵盖了日常使用的方方面面:

6.1 核心常用命令速查表

操作类别命令格式说明
安装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检查系统环境是否存在问题(排错神器)

6.2 详细命令分类解析

6.2.1 搜索与发现 (search, info)

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

查看软件信息:

brew info git

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

搜索软件:

brew search google
brew search python
6.2.2 安装与卸载 (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 # 安装指定版本
6.2.3 更新与升级 (update, upgrade)

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

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

升级指定软件:

brew upgrade git

升级所有软件:

brew upgrade

更新软件列表:

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

保持系统整洁。

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

brew cleanup

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

查看可升级的软件:

brew outdated

列出已安装软件:

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

查看帮助:

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

诊断环境问题:

brew doctor

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

6.2.6 进阶小贴士

查看依赖树:

brew deps --installed --tree

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

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

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

目录

  1. macOS Homebrew 完全指南
  2. 一、前言介绍
  3. 为什么需要 Homebrew?
  4. 二、核心概念
  5. 三、下载安装
  6. 四、验证安装
  7. 五、切换国内镜像
  8. 5.1 替换主仓库
  9. 5.2 可选替代
  10. 六、常用指令
  11. 6.1 核心常用命令速查表
  12. 6.2 详细命令分类解析
  13. 6.2.1 搜索与发现 (search, info)
  14. 6.2.2 安装与卸载 (install, uninstall)
  15. 6.2.3 更新与升级 (update, upgrade)
  16. 6.2.4 状态与清理 (list, cleanup, outdated)
  17. 6.2.5 诊断与帮助 (doctor, help)
  18. 6.2.6 进阶小贴士
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

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

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

更多推荐文章

查看全部
  • New API 详解:开源大模型统一网关与 AI 资产管理系统
  • AIGC 插画创作技术解析与代码实战
  • VSCode Copilot 接入智谱 GLM-5.1 与自定义大模型方案
  • DreamShaper XL Lightning 模型发布与使用指南
  • 2024 年转行 AI 产品经理的时机与准备指南
  • 2026 年 AI 领域十大热点话题深度解析
  • OpenAI 与 LangChain 集成实战指南
  • Windows 上安装 WSL Ubuntu 避坑指南:从报错到成功运行
  • 大模型量化详解:基于 llama.cpp 的 GGUF 转换与量化
  • VR-Reversal 工具实现 3D 视频转 2D 使用教程
  • Ubuntu ISO 镜像下载地址汇总
  • LangChain4j 中 RAG 系统文档加载、解析与分块策略详解
  • QClaw 上手指南:本地 AI 代理工具深度体验
  • 企业微信可信 IP 配置:无备案域名的 Python 实现
  • 飞书机器人图片消息发送流程及常见问题解决
  • RTX 4070 本地部署 Stable Diffusion 教程:环境搭建与 4K 人像生成
  • iOS 26 系统兼容适配:UITabBar 液态玻璃效果与 WiFi SSID 获取
  • 2024 人工智能大模型发展现状、应用案例与总结展望
  • 低空无人机 AI 算法详解:涵盖公安、消防、水利等十大领域
  • 本地部署 Qwen 2.5-Coder 大模型:硬件要求与软件配置指南

相关免费在线工具

  • 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