【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 就拥有了一个强大的包管理器,以后装开发软件再也不用到处找安装包了。

相关文章
|
1月前
|
人工智能 IDE 开发工具
【开发者必看】WindSurf官网下载安装:AI编程IDE让写代码更轻松
Windsurf 是 Codeium 推出的新一代 AI 原生 IDE,深度集成 Cascade 智能代理,支持实时代码库理解、多行智能补全、自然语言驱动的跨文件修改与错误诊断。区别于插件式方案,它从底层重构开发体验,免费版即享核心功能。(239字)
|
2月前
|
Oracle 关系型数据库 iOS开发
2026最新!VirtualBox 7.2.8免费虚拟机安装保姆教程(新手零门槛上手)
Oracle VM VirtualBox 是 Oracle 推出的开源免费虚拟机软件,支持 Windows/macOS/Linux/Solaris,最新版 7.2.8 新增 ARM 架构支持。轻量易用、跨平台兼容,适合个人用户与开发者搭建测试环境、运行多系统。(239字)
|
Linux iOS开发 MacOS
brew - mac 下的 brew 切换为国内源
brew - mac 下的 brew 切换为国内源
6975 0
|
5月前
|
缓存 数据可视化 Linux
用Mac的朋友们,你们都在使用Homebrew了吗
Homebrew是macOS/Linux主流包管理器,支持命令行工具(`brew install`)和GUI应用(`brew install --cask`)的一键安装、升级、搜索与卸载。提供官网及国内镜像安装方式,附带Applite等图形化管理工具,大幅提升Mac软件管理效率。(239字)
1323 1
|
2月前
|
人工智能 JSON Linux
CC Switch安装:AI 编程工具统一管理平台,告别手动改配置文件(2026最新)
CC-Switch 是一款开源跨平台AI编程工具配置管理器,支持Claude Code、Codex、Gemini CLI等7款主流工具。v3.16.3版提供图形化API切换、MCP管理、Skills插件、用量统计与健康检查,告别手动改JSON,本地加密存储,安全高效。(239字)
|
2月前
|
人工智能 小程序 程序员
Skill详解(2万字详细教程),Skills是什么,如何安装并使用Skills
AI时代必备技能!Skills(智能体技能)是Anthropic提出的可复用能力包,以文件夹形式封装指令、脚本与资源,实现“按需加载”,大幅节省Token。它让大模型从聊天工具升级为专业助手——非技术岗也能零代码快速上手,真正实现人人可用、岗岗必备。
11448 14
Skill详解(2万字详细教程),Skills是什么,如何安装并使用Skills
|
1月前
|
人工智能 自然语言处理 前端开发
百炼 Skills 实战:novel-game——让零基础用户把故事变成可玩的互动小说游戏
novel-game 是百炼官方推出的互动小说创作 Skill,无需编程即可一键生成完整视觉小说。融合 Qwen、Wan、HappyHorse、CosyVoice 多模态 AI,自动产出剧情、立绘、动画、配音及程序化音效,输出可离线运行的 React 游戏,支持分支叙事与多端适配。(239字)
|
1月前
|
运维 Linux 网络安全
2026最新Xshell安装+远程连接零门槛上手(图文版)
Xshell 是 NetSarang 开发的专业 SSH 客户端,专为 Windows 用户远程管理 Linux 服务器设计。支持多标签、会话保存、SSH 密钥、端口转发及 X11 转发,并与 Xftp 无缝协同(Xshell 管命令,Xftp 管传文件)。界面友好、中文支持佳、稳定高效,是运维、开发人员的首选工具。(239 字)
完美解决 fatal: unable to access ‘https://github.com/Homebrew/brew/‘
完美解决 fatal: unable to access ‘https://github.com/Homebrew/brew/‘
3048 0