【2026实测】Homebrew安装+配置国内源+使用一篇搞定(多种安装方式)

简介: Homebrew 是 macOS 最流行的开源包管理器,被誉为“macOS 缺失的包管理器”。一行命令即可安装、更新、卸载命令行工具(如 Git、Python)和图形应用(如 Chrome、VS Code),自动处理依赖与环境配置,大幅提升开发效率。(239 字)

Homebrew 是 macOS 上最流行的包管理工具,完全免费开源,也被称为"macOS 缺失的包管理器"。它的核心作用就是让你能用一行命令安装、更新、管理各种开发工具和软件,比如 Git、Python、Node.js、Wget 等,不用再跑到各个软件的官网去手动下载安装包了。


在没有 Homebrew 的时代,在 macOS 上装开发工具是一件挺折腾的事。去官网找安装包、手动解决依赖关系、升级卸载还容易残留文件。Homebrew 改变了这一切,brew install 一条命令自动完成下载、解决依赖、编译安装和环境配置。


同领域的包管理工具各有各的适用场景:


工具 平台 核心定位 软件来源 图形界面应用
Homebrew macOS / Linux 通用包管理 Formula + Cask ✓ brew install --cask
MacPorts macOS 类Unix包管理 Portfile 部分支持
Spack Linux / macOS 科学计算包管理 Package recipe
APT (Linux) Linux 发行版 系统包管理 Debian 仓库


Homebrew 的核心概念不多,搞懂了就很好上手:

  • Formula 是命令行工具的安装配方,用来安装 Git、Python 这类工具;
  • Cask 是用来装图形界面应用的,比如 Chrome、VS Code、微信这类带图标的软件;
  • Tap 是第三方仓库,可以添加额外的软件源。


下面从安装开始,一步步教你用起来。

安装Homebrew

安装 Homebrew 有多种方式,官网提供了官方安装脚本,直接一条命令就能装,也可以下载 homebrew.pkg 离线安装包,下载后本地运行。

1) 下载pkg安装包(新手推荐看,系统版本至少 macOS 14)

这种方式不需要开终端输命令,对不熟悉命令行的用户更友好,也适合在局域网里分发批量安装。


下载 homebrew.pkg 安装包:homebrew.pkg(源自 Github,放心使用)


直接双击 homebrew.pkg 打开,安装向导会自动引导你完成安装:



和装其他 macOS 软件一样,一路继续就行。安装完成后 Homebrew 会自动安装到默认路径,Apple Silicon 芯片的 Mac 装到 /opt/homebrew,Intel 芯片的 Mac 装到 /usr/local。

2)脚本安装Homebrew

安装 Homebrew 前需要先安装 Command Line Tools,在终端里输入以下命令:

xcode-select --install

执行后会弹窗提示安装,点击"安装"等待完成就行。这一步是必须的,Homebrew 依赖 Xcode 的命令行工具来编译软件。

① 国内镜像安装Homebrew

国内用户直接跑官方脚本可能会非常慢甚至连不上,推荐用国内镜像安装脚本,一条命令搞定:

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

输入命令后会提示输入序号,比如选择 1:



继续输入电脑密码:



输入 y:



按回车键继续:



再次输入密码:



安装 Homebrew 成功后,可以继续配置软件下载源:


② 官方脚本安装Homebrew

如果你网络环境好,可以正常访问 Github,可以直接用官方脚本:

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

③ Git 克隆安装

如果前两种都因为网络问题搞不定,可以用 Git 克隆的方式:

sudo git clone https://github.com/Homebrew/brew /opt/homebrew

克隆完成后把 brew 添加到 PATH 环境变量里就能用了。这种方式的优点是离线也能搞,只要有一次拿到完整的 Git 仓库就行。

验证安装Homebrew

安装完成后,终端输入 brew --version 查看版本号,如果显示了版本号(格式为:Homebrew  x.x.x)说明 Homebrew 安装成功:



再跑一下 brew doctor,这个命令会检查 Homebrew 的环境状态,如果有问题会给出修复建议,没有红色警告和错误就是正常状态。

Homebrew配置国内镜像源

前面没有配置国内下载源的,可以参考下面的步骤手动配置。


安装完成后,强烈建议把 Homebrew 的镜像源换成国内的,否则后面装软件会非常慢。这里推荐两种,选一个设置就行。


中科大镜像源:

git -C "$(brew --repo)" remote set-url origin https://mirrors.ustc.edu.cn/brew.git
git -C "$(brew --repo homebrew/core)" remote set-url origin https://mirrors.ustc.edu.cn/homebrew-core.git
git -C "$(brew --repo homebrew/cask)" remote set-url origin https://mirrors.ustc.edu.cn/homebrew-cask.git


清华大学镜像源:

git -C "$(brew --repo)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git
git -C "$(brew --repo homebrew/core)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git
git -C "$(brew --repo homebrew/cask)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-cask.git


切换完后还可以配置环境变量加速下载:编辑 ~/.zshrc 文件(nano ~/.zshrc),在末尾添加三行配置:

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"

保存退出后 source ~/.zshrc 让配置生效,再运行 brew update 更新一下,后续下载速度会明显提升。

Homebrew基础使用

Homebrew 的常用命令不多,掌握下面这张表里的几个核心操作就能应付绝大部分场景:


操作 命令格式 说明
搜索软件 brew search 关键字 搜索可用的软件包,如 brew search python
查看信息 brew info 软件名 查看版本、依赖、安装说明等详细信息
安装命令行工具 brew install 软件名 自动下载解压配置环境,如 brew install git
安装图形界面应用 brew install --cask 应用名 命令行版应用商店,如 brew install --cask google-chrome
更新软件列表 brew update 刷新本地软件列表,装新软件前建议先跑
升级已装软件 brew upgrade [软件名] 不指定软件名则升级全部已装软件
卸载软件 brew uninstall [--cask] 软件名 图形界面应用需加上 --cask
查看已装软件 brew list [--cask] 列出已安装的软件,加 --cask 只看图形界面应用
清理缓存 brew cleanup 删除旧版本安装包和缓存,释放硬盘空间
诊断环境 brew doctor 检查 Homebrew 环境,排错神器,遇到报错先跑这个


还有一些进阶小技巧:

  • 如果不想某个软件被升级,可以用 brew pin 软件名 锁定版本,brew unpin 软件名 解锁。
  • 用 brew deps --installed --tree 可以查看当前已装软件的依赖关系树,对自己装了什么东西很清楚。

常见使用问题

1)安装时提示"Permission denied"权限不足

这是因为 Homebrew 安装目录的权限问题,可以用 sudo chown -R $(whoami) $(brew --prefix)/* 修改目录权限,把所有权从 root 改成当前用户。不过在新版 Homebrew 中这个问题已经很少出现了,如果遇到,先试试 brew doctor 看它给出的修复建议。

2)brew update 非常慢或者卡住不动

这是国内用户最常见的问题,原因是从 GitHub 拉取数据时网络不稳定。解决方案就是上面说的配置国内镜像源,换成中科大或清华的源之后速度会快很多。如果已经配置了镜像但还是慢,检查一下环境变量有没有生效,重新 source 一下配置文件。

3)安装软件时提示 Homebrew 版本太旧

先跑 brew update 更新 Homebrew 自身和软件列表,然后再 brew install。如果 update 后还是提示旧版本,可能是镜像源没有及时同步,换一个镜像源试试。

4)想恢复官方源怎么办

修改镜像源的命令反过来就行,把远程地址改回 GitHub 官方地址:

#  brew.git
git -C "$(brew --repo)" remote set-url origin https://github.com/Homebrew/brew.git
#  homebrew-core.git
git -C "$(brew --repo homebrew/core)" remote set-url origin https://github.com/Homebrew/homebrew-core.git
#  homebrew-cask.git
git -C "$(brew --repo homebrew/cask)" remote set-url origin https://github.com/Homebrew/homebrew-cask.git

同时把 ~/.zshrc 里的 HOMEBREW 环境变量注释掉或删掉,source 之后 brew update 一下就能切回官方源。

总结

Homebrew 是 macOS 开发者几乎绕不开的工具,安装一次受益终身。从多种安装方式中选择最适合你的那条,国内用户强烈推荐镜像安装脚本,装好之后第一时间配置国内镜像源,速度差真的很大。


日常使用 Homebrew 只需要记住 brew install(装工具)、brew install --cask(装应用)、brew update/upgrade(更新)、brew doctor(排错)这几条命令就够了。跟着上面的步骤走完,你的 Mac 就拥有了一个强大的包管理器,以后装开发软件再也不用到处找安装包了。

相关文章
|
6月前
|
缓存 数据可视化 Linux
用Mac的朋友们,你们都在使用Homebrew了吗
Homebrew是macOS/Linux主流包管理器,支持命令行工具(`brew install`)和GUI应用(`brew install --cask`)的一键安装、升级、搜索与卸载。提供官网及国内镜像安装方式,附带Applite等图形化管理工具,大幅提升Mac软件管理效率。(239字)
1411 1
完美解决 fatal: unable to access ‘https://github.com/Homebrew/brew/‘
完美解决 fatal: unable to access ‘https://github.com/Homebrew/brew/‘
3112 0
|
2月前
|
人工智能 IDE 开发工具
【开发者必看】WindSurf官网下载安装:AI编程IDE让写代码更轻松
Windsurf 是 Codeium 推出的新一代 AI 原生 IDE,深度集成 Cascade 智能代理,支持实时代码库理解、多行智能补全、自然语言驱动的跨文件修改与错误诊断。区别于插件式方案,它从底层重构开发体验,免费版即享核心功能。(239字)
|
Linux iOS开发 MacOS
brew - mac 下的 brew 切换为国内源
brew - mac 下的 brew 切换为国内源
7066 0
|
2月前
|
Web App开发 程序员 Linux
【2026最新】Chocolatey包管理器下载使用指南(程序员必备)
Chocolatey 是 Windows 免费开源命令行包管理器,支持一键安装、更新、卸载软件(如 choco install chrome),省去手动下载与配置。软件库丰富,社区活跃,媲美 Linux 的 apt/yum。另有 Winget(微软官方)、Scoop(便携优先)可选。
|
23天前
|
文字识别 安全 Windows
【2026】Umi-OCR文字识别工具:截图/批量/PDF识别全支持
Umi-OCR是一款免费开源的离线OCR软件,支持截图、图片、扫描PDF文字识别,全程本地运行,保障隐私安全。提供Paddle(高性能)和Rapid(低配兼容)双引擎,操作简单,支持批量处理与多格式导出。
|
2月前
|
存储 Linux iOS开发
【2026最新】MarkText下载中文版|MarkText安装使用图解(超详细)
MarkText 是一款免费开源的 Markdown 编辑器,支持所见即所得实时渲染,无需分屏预览。跨平台(Windows/macOS/Linux),内置中英文界面、数学公式(KaTeX)、代码高亮,可一键汉化,是 Typora 的优秀免费替代品。(239字)
|
2月前
|
程序员 Linux 开发工具
【2026最新】Vim下载|gvim下载、安装、使用手把手图文(超详细)
Vim 是一款免费、跨平台、高度可定制的文本编辑器,由 Bram Moolenaar 基于 vi 开发,已有三十多年历史。它以多模式(普通/插入/可视)设计著称,支持语法高亮、代码补全、宏录制等编程友好功能,资源占用极低,深受程序员及系统管理员青睐。(239字)
|
2月前
|
人工智能 自然语言处理 前端开发
百炼 Skills 实战:novel-game——让零基础用户把故事变成可玩的互动小说游戏
novel-game 是百炼官方推出的互动小说创作 Skill,无需编程即可一键生成完整视觉小说。融合 Qwen、Wan、HappyHorse、CosyVoice 多模态 AI,自动产出剧情、立绘、动画、配音及程序化音效,输出可离线运行的 React 游戏,支持分支叙事与多端适配。(239字)
|
2月前
|
人工智能 自然语言处理 API
阿里云百炼Qwen3.7-Max模型功能、免费Tokens、订阅计费及配置接入指南
Qwen3.7-Max是阿里云百炼推出的旗舰级大模型,具备超强推理、编程、智能体原生支持与多模态理解能力,专为高要求AI场景设计。新用户可免费领取100万Tokens,支持按量计费、资源包订阅及专属部署,接入便捷,合规安全。在阿里云百炼官网:https://t.aliyun.com/U/fPVHqY 免费领取千万Tokens
1203 4