Skip to content

Homebrew

标签:Mac
创建时间:2026年11月05日 00:56:38

安装前的准备 ​

安装 Xcode ​

在安装 Homebrew 之前,建议先安装 Xcode Command Line Tools(命令行工具),因为 brew 编译或安装某些软件时依赖它。

bash
xcode-select --install

系统会弹窗提示安装,点击“安装”并等待完成即可。

配置 CURL 代理 ​

端口号取决于你本地的梯子工具,如果没有梯子可以忽略这一步,只不过后面的进度会很慢。

推荐一个梯子:阿里加速器

bash
export http_proxy=http://127.0.0.1:6450;
export https_proxy=http://127.0.0.1:6450;

验证代理是否生效:

bash
curl -v https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh -o /dev/null

配置成功后,上面代码的运行结果中会出现:Uses proxy env variable https_proxy == 'http://127.0.0.1:6450

安装 brew ​

开始安装 ​

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

安装完成后执行移除环境变量指令,避免下次开启终端走代理。如果没配置代理可忽略此步骤。

bash
unset http_proxy https_proxy

将 brew 加入环境变量,并立即生效

bash
echo 'eval "$(/opt/homebrew/bin/brew shellenv zsh)"' >> ~/.zprofile

source ~/.zprofile

查看 brew 版本

bash
brew --version

此时运行后将看到 brew 对应的版本号

设置 brew 国内镜像 ​

设置 API 镜像(新版 Homebrew 核心):

bash
echo 'export HOMEBREW_API_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api"' >> ~/.zprofile

设置 Bottle 镜像(下载软件包的地址):

bash
echo 'export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles"' >> ~/.zprofile

替换 brew 核心程序的 Git 仓库:

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

让配置立即生效

bash
source ~/.zprofile

检查配置

bash
brew config

常用指令 ​

软件及环境 ​

操作命令说明
搜索brew search <关键字>查找可用的软件(支持模糊搜索)
查看详情brew info <包名>查看软件版本、依赖关系、安装路径等详细信息
安装(命令行)brew install <包名>例如 brew install wget
安装(图形应用)brew install --cask <应用名>例如 brew install --cask google-chrome
卸载brew uninstall <包名>卸载软件(如果是 Cask 应用,必须加 --cask)
查看已安装brew list查看所有已安装的包(可加 --formula 或 --cask 过滤)
更新软件列表brew update获取最新的软件版本列表(不升级软件本身)
升级软件brew upgrade升级所有可升级的包(也可指定包名,如 brew upgrade node)
诊断brew doctor检查 Homebrew 环境是否存在问题
清理brew cleanup删除旧版本缓存和没用的安装包,释放磁盘空间
查看依赖brew deps <包名>查看某个软件依赖了哪些底层库(可加 --tree 看树状图)
查看谁依赖了它brew uses --installed <包名>查看当前已安装的软件中,哪些依赖了这个包(卸载前很有用)
导出软件列表brew bundle dump在当前目录生成一个 Brewfile,记录你装过的所有软件
按列表安装brew bundle install读取 Brewfile 并一键安装里面记录的所有软件(换新电脑必备)

环境相关 ​

操作命令说明
查看服务列表brew services list查看所有通过 Homebrew 管理的服务状态(started/stopped/error)
启动服务brew services start <服务名>启动服务,并设置为开机自启(例如 brew services start mysql)
停止服务brew services stop <服务名>停止服务,并取消开机自启
重启服务brew services restart <服务名>重启服务(修改配置文件后必须执行此命令才能生效)
仅运行一次brew services run <服务名>启动服务,但不会设置开机自启(电脑重启或注销后自动停止)
查看服务信息brew services info <服务名>查看指定服务的详细状态、PID 和日志文件路径
强制终止服务brew services kill <服务名>强制杀掉正在运行的服务进程(遇到服务卡死时使用)
清理无用服务brew services cleanup移除那些已失效或已被卸载但仍留在系统注册表里的旧服务

基于 MIT 许可发布