搜索文档
安装前的准备
安装 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 | 移除那些已失效或已被卸载但仍留在系统注册表里的旧服务 |
