Homebrew执行brew install时默认自动运行brew update,导致国内用户常卡在“Updating Homebrew…”;可通过设置HOMEBREW_NO_AUTO_UPDATE=1禁用该行为,显著提升安装速度,且不影响软件安装本身。
homebrew 在执行 brew install 时默认会先运行 brew update,这个步骤会拉取远程仓库的最新索引,但在国内网络环境下常卡在 “updating homebrew…”,导致每次安装都耗时很长。跳过它就能明显提速,而且不影响软件安装本身。
设置环境变量禁用自动更新
Homebrew 提供了官方支持的开关:通过设置 HOMEBREW_NO_AUTO_UPDATE=1,可让所有 brew install、brew search 等命令跳过自动更新环节。
- 打开终端,编辑你的 shell 配置文件(Zsh 用户通常是
~/.zshrc,Bash 用户是~/.bash_profile) - 添加这行:
export HOMEBREW_NO_AUTO_UPDATE=1
- 保存后执行
source ~/.zshrc(或对应配置文件)使生效 - 验证是否生效:运行
brew config | grep NO_AUTO_UPDATE,应显示HOMEBREW_NO_AUTO_UPDATE: 1
手动更新更可控
禁用自动更新不等于放弃更新。你可以按需主动执行 brew update,比如每周一次,或在安装重要软件前手动同步一次。
- 想只更新核心仓库(更快):
brew update --quiet - 想跳过某些慢源(如 cask):
brew update --no-cask - 配合国内镜像源使用效果更佳,避免 update 本身也卡住
临时跳过更新(应急用)
如果只是某次安装想快速跳过,不用改配置,直接加环境变量前缀即可:
部署和使用军舰的 macOS Automator 自动化服务集合。包含 5 个实用工作流:PDF转JPG、PNG重命名并转JPG、图像拼接、解压RAR、顺序命名图像文件。一键安装所有服务到 ~/Library/Services/ 目录。使用场景:(1) "安装我的自动化服务",(2) "部署所有 Automato...
HOMEBREW_NO_AUTO_UPDATE=1 brew install wget
这条命令只对当前这一次生效,适合测试或临时场景。
注意和常见误区
这个设置不会影响 brew upgrade 或 brew cleanup 的行为,它们本来就不触发自动 update。
- 不是所有命令都受控:只有
install、search、info等读取仓库数据的命令才会默认触发 update - 如果你用了国内镜像源(如清华源),再配合这个设置,安装体验基本就接近本地速度
- 不要误设成
HOMEBREW_NO_INSTALL_UPGRADE或其他变量,那个是控制升级时是否重装依赖的,和 update 无关

















