MacOS上Homebrew 安装、配置、更改国内镜像源及使用教程

Homebrew笔记

1. 介绍

官网：https://brew.sh/

对于习惯了使用命令来完成一切的程序员来说，安装软件这种小事，自然是能够用命令解决，就不用图形界面选择。但是在 Linux 中，我们有 yum、apt、dnf、pkg等命令来完成软件的安装，macOS 却并未为我们提供一个好用的包管理器，帮助我们更好的使用 macOS。

好在，虽然官方没有提供，我们却可以使用 Homebrew 这一神器，来完成类似的工作，就如同 Homebrew 的 Slogan ：“The missing package manager for macOS (or Linux)”

Homebrew 由开发者 Max Howell 开发，并基于 BSD 开源，是一个非常方便的包管理器工具。在早期， Homebrew 仅有 macOS 的版本，后续随着用户的增多，Homebrew 还提供了 Linux 的版本，帮助开发者在 Linux 同样使用 Homebrew 来配置环境。

1.1 组成部分

Homebrew 是一款包管理工具，目前支持 macOS 和 linux 系统。主要有四个部分组成: brew、homebrew-core 、homebrew-cask、homebrew-bottles。

名称说明brewHomebrew 源代码仓库homebrew-coreHomebrew 核心源homebrew-cask提供 macOS 应用和大型二进制文件的安装homebrew-bottles预编译二进制软件包

1.2 核心概念

在正式介绍 Homebrew 的使用之前，我先为你介绍一下 Homebrew 中的一些核心的概念，了解这些概念，就可以帮助你更好的去使用 Homebrew。

词汇含义formula (e)安装包的描述文件，formulae 为复数cellar安装好后所在的目录keg具体某个包所在的目录，keg 是 cellar 的子目录bottle预先编译好的包，不需要现场下载编译源码，速度会快很多；官方库中的包大多都是通过 bottle 方式安装tap下载源，可以类比于 Linux 下的包管理器 repositorycask安装 macOS native 应用的扩展，你也可以理解为有图形化界面的应用。bundle描述 Homebrew 依赖的扩展

其中，最关键的是 tap 、cask，我们在后续会经常用到。

2. 安装

复制下方命令到终端一键执行即可，我这里用的第一个，是一个知乎博主分享的。

苹果电脑 常规安装脚本（推荐 完全体 几分钟安装完成）：

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

苹果电脑 极速安装脚本（精简版 几秒钟安装完成）：

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

苹果电脑 卸载脚本：

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

常见错误去下方地址查看

https://gitee.com/cunkai/HomebrewCN/blob/master/error.md

Linux电脑 安装脚本：

rm Homebrew.sh ; wget https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh ; bash Homebrew.sh

Linux电脑 卸载脚本：

rm HomebrewUninstall.sh ; wget https://gitee.com/cunkai/HomebrewCN/raw/master/HomebrewUninstall.sh ; bash HomebrewUninstall.sh

3. 更换为国内镜像源

本教程以更改中科大源为例。

中科大源地址：https://mirrors.ustc.edu.cn/

Homebrew 源使用帮助 http://mirrors.ustc.edu.cn/help/brew.git.htmlHomebrew Core 源使用帮助 http://mirrors.ustc.edu.cn/help/homebrew-core.git.htmlHomebrew Cask 源使用帮助 http://mirrors.ustc.edu.cn/help/homebrew-cask.git.htmlHomebrew Bottles 源使用帮助 http://mirrors.ustc.edu.cn/help/homebrew-bottles.html

最终效果查看，最下面的两行 origin 表示，按照 3.1 教程演示即可

# 切换当前工作目录到 Homebrew 的仓库目录

cd "$(brew --repo)"

#显示当前工作目录的路径

pwd

# 查看当前 Git 仓库所配置的远程仓库的详细信息

git remote -v

git remote -v 命令用于查看当前 Git 仓库的远程仓库信息。

输出结果显示 origin https://mirrors.ustc.edu.cn/brew.git (fetch) 和 origin https://mirrors.ustc.edu.cn/brew.git (push) 。这表明当前 Homebrew 仓库的远程源（名为origin）的 URL 是 https://mirrors.ustc.edu.cn/brew.git 。(fetch)表示从这个 URL 拉取代码更新，(push)表示向这个 URL 推送代码更改。

以上为最终效果，大家最后有时间看就行

3.1 更换 brew.git 源

执行下方命令，并看到 ORIGNN 地址已经更新

# 切换到 Homebrew 的仓库目录

cd "$(brew --repo)"

# 设置 Homebrew 仓库的远程源 URL 为中国科学技术大学的镜像地址

git remote set-url origin https://mirrors.ustc.edu.cn/brew.git

# 显示当前 Homebrew 的配置信息，如各种配置参数，如版本号、安装路径、镜像地址等

brew config

重置为官方镜像：

cd "$(brew --repo)"

git remote set-url origin https://github.com/Homebrew/brew.git

3.2 更换 homebrew-core.git 源

通过下方命令发现错误，这个错误信息表明 Git 认为在 “/opt/homebrew/Library/Taps/homebrew/homebrew-core” 这个路径下的仓库所有权存在可疑情况。这通常是由于安全机制引起的，Git 可能担心该仓库不是在安全的环境下或者可能存在恶意操作的风险。

cd "$(brew --repo)/Library/Taps/homebrew/homebrew-core"

git remote set-url origin https://mirrors.ustc.edu.cn/homebrew-core.git

按照要求执行命令，这个命令会将指定的目录添加到 Git 的安全目录列表中，告诉 Git 这个目录是安全的，可以进行操作。这样，在后续执行与这个仓库相关的 Git 操作时，就不会再出现这个错误了。

git config --global --add safe.directory /opt/homebrew/Library/Taps/homebrew/homebrew-core

git remote set-url origin https://mirrors.ustc.edu.cn/homebrew-core.git

# 重置为官方地址：

cd "$(brew --repo)/Library/Taps/homebrew/homebrew-core"

git remote set-url origin https://github.com/Homebrew/homebrew-core

默认不安装 cask 有需要的可以替换（Homebrew cask 软件仓库，提供 macOS 应用和大型二进制文件），这个我没弄，我就不演示了。

cd "$(brew --repo)"/Library/Taps/homebrew/homebrew-cask

git remote set-url origin https://mirrors.ustc.edu.cn/homebrew-cask.git

# git remote set-url origin git://mirrors.ustc.edu.cn/homebrew-cask.git

# 重置为官方地址：

cd "$(brew --repo)"/Library/Taps/homebrew/homebrew-cask

git remote set-url origin https://github.com/Homebrew/homebrew-cask

3.3 替换 Homebrew-bottles 源

用以下命令查看终端使用的是 Bash 还是 Zsh

echo $SHELL

bash 用户

echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles' >> ~/.bash_profile

source ~/.bash_profile

zsh 用户

echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles' >> ~/.zshrc

source ~/.zshrc

brew4.x 系列有个 api 加速环境变量，是如下命令。阿里云镜像是上下两个变量HOMEBREW_BOTTLE_DOMAIN 和 HOMEBREW_API_DOMAIN 都有的，只需要吧里面的 ustc 换成 aliyun即可 。然后这里我使用中科大 api 加速。后续 Homebrew 在使用 API 时会通过中科大的镜像加速地址来提高访问速度。

bash 用户

echo 'export HOMEBREW_API_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles/api'>>~/.bash_profile

source ~/.bash_profile

zsh 用户

echo 'export HOMEBREW_API_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles/api'>>~/.zshrc

source ~/.zshrc

4. 常用命令

4.1 安装卸载软件

brew --version 或者 brew -v 显示 brew 版本信息brew install 安装指定软件brew uninstall 卸载指定软件brew list 显示所有的已安装的软件brew search text 搜索本地远程仓库的软件，已安装会显示绿色的勾brew search /text/ 使用正则表达式搜软件brew info 显示指定软件信息brew reinstall 重新安装指定软件，先卸载后安装brew install --build-from-source 源码安装指定软件，可以给定指定参数brew commands 列出所有可用命令

4.2 升级软件相关

brew update 自动升级 homebrew （从 github 下载最新版本）brew outdated 检测已经过时的软件brew upgrade 升级所有已过时的软件，即列出的以过时软件brew upgrade 升级指定的软件brew pin 禁止指定软件升级brew unpin 解锁禁止升级brew upgrade --all 升级所有的软件包，包括未清理干净的旧版本的包brew edit 编辑软件，不会的情况下慎用brew tap 列出本地资源仓库，其中 homebrew 是默认仓库，其它都是第三方仓库brew tap 添加第三方仓库，命名的规则按照 github 来定的。使用brew untap 删除仓库brew deps 查看指定软件依赖于哪些软件brew uses 查看指定软件被哪些软件所依赖

4.3 清理相关

homebrew 再升级软件时候不会清理相关的旧版本，在软件升级后我们可以使用如下命令清理

brew cleanup -n 列出需要清理的内容brew cleanup 清理指定的软件过时包brew cleanup 清理所有的过时软件brew unistall 卸载指定软件brew unistall --force 彻底卸载指定软件，包括旧版本

通过 brew 安装的文件会自动设置环境变量，所以不用担心命令行不能启动的问题。 比如安装好了 gradle，即可运行 gradle -v

4.4 管理后台服务

macOS 使用 launchctl 命令加载开机自动运行的服务，brew service 可以简化 lauchctl 的操作。

以 MySQL 为例，使用 launchctl 启动:

ln -sfv /usr/local/opt/mysql/*.plist ~/Library/LaunchAgents

launchctl load ~/Library/LaunchAgents/homebrew.mxcl.mysql.plist

如使用 brew service 可以简化为:

brew services start mysql

services 常用命令

brew services list # 查看使用brew安装的服务列表brew services run formula|–all # 启动服务（仅启动不注册）brew services start formula|–all # 启动服务，并注册brew services stop formula|–all # 停止服务，并取消注册brew services restart formula|–all # 重启服务，并注册brew services cleanup # 清除已卸载应用的无用的配置

配置文件目录

/Library/LaunchDaemons # 开机自启，需要sudo

~/Library/LaunchAgents # 用户登录后自启

以 homebrew.mxcl.kafka.plist 为例：

Label

homebrew.mxcl.kafka

WorkingDirectory

/usr/local

ProgramArguments

/usr/local/opt/kafka/bin/kafka-server-start

/usr/local/etc/kafka/server.properties

RunAtLoad

KeepAlive

StandardErrorPath

/usr/local/var/log/kafka/kafka_output.log

StandardOutPath

/usr/local/var/log/kafka/kafka_output.log

在这里可以找到服务路径、启动参数、日志路径等

4.5 brew cask

Homebrew Cask 是 Homebrew 的扩展，借助它可以方便地在 macOS 上安装图形界面程序，即我们常用的各类应用。Homebrew 中文含义为自制、自酿酒，Cask 中文含义为桶、木桶，桶装酒是一种成品，也就是说每一个 homebrew cask 都可以直接使用的，比如 Atom 的 Cask 名称为 atom，那么就可以使用如下命令安装：

brew cask install atom

甚至也可以提交新的 Cask，比如假设有桌面客户端少数派，则用 brew cask create sspai 创建新的名称为 sspai 的 Cask，当然还要提供官网下载链接、官方主页、应用版本等信息，可以参照 官方教程，此处就不再细说。

安装 Homebrew Cask【以后新版不需要安装】 安装好 brew 后，就可以执行命令 brew tap caskroom/cask 获取 Homebrew Cask。

注意： Caskroom 的 Git 地址在 2018 年 5 月 25 日从 https://github.com/caskroom/homebrew-cask 迁移到了 https://github.com/Homebrew/homebrew-cask 所以，以后就不需要安装 Homebrew Cask

4.6 使用 Homebrew Cask

github 使用：https://github.com/Homebrew/homebrew-cask/blob/master/USAGE.md

brew cask install 安装指定图形界面软件brew cask uninstall 卸载软件brew cask uninstall --force 卸载软件，带参数brew cask search text 搜索软件brew cask list 列出所有通过 cask 安装的软件其它可以参考：https://github.com/Homebrew/homebrew-cask/blob/master/USAGE.md

举例可安装的软件

# 安装chrome

brew cask install google-chrome

# 安装LaunchRocket

brew cask install launchrocket

5. 图像化工具 cakebrew

官方地址：https://www.cakebrew.com/

Github 仓库地址：https://github.com/brunophilipe/Cakebrew

点击上方导航栏的 Download，再点击 Download Now 就下载安装包，然后解压的程序拖到应用程序即可。

或者通过 Homebrew 命令安装：

brew install --cask cakebrew

打开后，有点不太稳定，显示不了界面

大家可以到网上搜搜使用教程，比命令行方便些。

参考

https://zhuanlan.zhihu.com/p/111014448 安装https://sspai.com/post/56009#! 1.2 核心概念、3https://blog.csdn.net/Amio_/article/details/109694893 1.1 组成部分https://cloud.tencent.com/developer/article/1867824https://zhuanlan.zhihu.com/p/366354601 介绍 Homebrew 图形化工具 cakebrew