Mac OSX 下高效安装 homebrew 及完美避坑姿势

刺骨的言语ヽ痛彻心扉 2022-11-03 04:22 104阅读 0赞

# Mac OSX 下高效安装 homebrew 及完美避坑姿势 #

## Homebrew 是什么 ##

Homebrew是 mac的包管理器，仅需执行相应的命令,就能下载安装需要的软件包，可以省掉自己去下载、解压、拖拽(安装)等繁琐的步骤。 比如安装服务器 nginx，打开终端执行以下命令即可安装:

brew install nginx

> Homebrew 官方文档 [https://brew.sh/][https_brew.sh]

# #

## Homebrew 怎么安装 ##

### 方法一：brew官网的安装脚本 ###

执行命令：

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

这时很可能会出现一个问题: 要么下载极其龟速，要么直接出现如下提示

curl: (7) Failed to connect to raw.githubusercontent.com port 443: Connection refused

> 原因：这是 [http://raw.githubusercontent.com][http_raw.githubusercontent.com] 访问不稳定引起的。

此时需要换一种科学高效的安装方法，即方法二。

### 方法二：brew 镜像安装脚本（亲测最快速最有效） ###

/usr/bin/ruby -e "$(curl -fsSL https://cdn.jsdelivr.net/gh/ineo6/homebrew-install/install)"

> 该脚本用了中科大镜像加速访问，仅修改仓库地址部分，不会产生安全隐患。 关于中科大所提供的 Homebrew 镜像服务 [https://lug.ustc.edu.cn/wiki/mirrors/help/brew.git][https_lug.ustc.edu.cn_wiki_mirrors_help_brew.git]

注：注意这里的速度，几百kib/s或几m/s才是正常的。若只有几kib/s，通常为无效的安装方法，一般加载了百分之几十后就会报错。  
![ac3d20912216335d5f63746748139a0c.png][]

# #

## Homebrew 安装时如何避坑 ##

1.若出现 Error: Checksum mismatch.

报错代码如下：

curl: (56) LibreSSL SSL_read: SSL_ERROR_SYSCALL, errno 54
    Error: Checksum mismatch.
    Expected: b065e5e3783954f3e65d8d3a6377ca51649bfcfa21b356b0dd70490f74c6bd86
    Actual: e8a348fe5d5c2b966bab84052062f0317944122dea5fdfdc84ac6d0bd513c137
    Archive: /Users/joyce/Library/Caches/Homebrew/portable-ruby-2.6.3_2.yosemite.bottle.tar.gz
    To retry an incomplete download, remove the file above.
    Error: Failed to install Homebrew Portable Ruby (and your system version is too old)!
    Failed during: /usr/local/bin/brew update --force

这里是由Homebrew目录下的portable-ruby-2.6.3\_2.yosemite.bottle.tar.gz文件引起的安装中断，只需要到上面对应的路径里，删掉这个文件，重新执行安装命令即可：

/usr/bin/ruby -e "$(curl -fsSL https://cdn.jsdelivr.net/gh/ineo6/homebrew-install/install)"

### 2.若卡在了Cloning into... ###

![51e9f5a8153c0412bf0440ff2353950f.png][]  
由这里的龟速可断定卡住了，立马用Control + C中断脚本，然后执行以下命令：

cd "$(brew --repo)/Library/Taps/"
    mkdir homebrew && cd homebrew
    git clone git://mirrors.ustc.edu.cn/homebrew-core.git

执行后可看到：

![148dffa10ae2df9a0a93fcac98bcd879.png][]  
速度立马快得飞起，一下子就能装好。

注：最后出现 Installation successful! 或者 Checking out files: 100% (5392/5392), done. 说明安装成功。

# #

## Homebrew安装完为何需要配置 ##

前面已经提到，Homebrew通常用来下载软件的，但它在安装软件时非常慢。为了提升安装速度，需要更改 Homebrew 的安装源，将其替换成国内镜像。

这里用的是由中科大负责托管维护的 Homebrew 镜像。其中，前两个为必须配置的项目，后两个可按需配置。

### 1.必备设置 ###

*  替换 brew.git：

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

*  替换 homebrew-core.git：

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

### 2.按需设置 ###

*  替换 homebrew-cask.git：

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

*  替换homebrew-bottles：

首先要先区分你的mac用哪种终端工具，如果是 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

注：Homebrew 主要由四个部分组成: brew、homebrew-core 、homebrew-cask、homebrew-bottles，它们对应的功能如下：

<table> 
 <thead> 
  <tr> 
   <th>组成</th> 
   <th>功能</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>Homebrew</td> 
   <td>源代码仓库</td> 
  </tr> 
  <tr> 
   <td>homebrew-core</td> 
   <td>Homebrew 核心源</td> 
  </tr> 
  <tr> 
   <td>homebrew-cask</td> 
   <td>提供macos应用和大型二进制文件的安装</td> 
  </tr> 
  <tr> 
   <td>homebrew-bottles</td> 
   <td>预编译二进制软件包</td> 
  </tr> 
 </tbody> 
</table>

# #

## Homebrew 基本用法有哪些 ##

// 查询：
    brew search 软件名
    
    // 安装：
    brew install 软件名
    
    // 卸载：
    brew uninstall 软件名
    
    // 更新 Homebrew：
    brew update 
    
    // 查看 Homebrew 配置信息：
    brew config

注：使用官方脚本同样会遇到uninstall地址无法访问问题，可以替换为下面脚本：

/usr/bin/ruby -e "$(curl -fsSL https://cdn.jsdelivr.net/gh/ineo6/homebrew-install/uninstall)"

# #

## 参考文章 ##

[mac下镜像飞速安装Homebrew教程][mac_Homebrew]

[科大Homebrew源][Homebrew]

# #

## 写在最后 ##

在此之前试过了好几种安装方法，比如下载一个 brew\_install.rb的文件，然后执行命令ruby brew\_install.rb，一开始行得通，但下载到中途就会报错，而且出错的方法不一，也尝试过好几种相应的解决方法，最终都夭折了，只有这个镜像安装才能成功，而且下载速度非常快。

转载来源：[https://www.cnblogs.com/joyce33/p/13376752.html][https_www.cnblogs.com_joyce33_p_13376752.html]

[https_brew.sh]: https://brew.sh/
[http_raw.githubusercontent.com]: http://raw.githubusercontent.com/
[https_lug.ustc.edu.cn_wiki_mirrors_help_brew.git]: https://lug.ustc.edu.cn/wiki/mirrors/help/brew.git
[ac3d20912216335d5f63746748139a0c.png]: /images/20221024/f2a66af7094943b5ae3b1a5913680660.png
[51e9f5a8153c0412bf0440ff2353950f.png]: /images/20221024/0fd486b485e045be9d684e0740c6a7b8.png
[148dffa10ae2df9a0a93fcac98bcd879.png]: /images/20221024/df307857e88240d0ad53a8d17bd2794f.png
[mac_Homebrew]: https://zhuanlan.zhihu.com/p/90508170
[Homebrew]: http://mirrors.ustc.edu.cn/help/brew.git.html#
[https_www.cnblogs.com_joyce33_p_13376752.html]: https://www.cnblogs.com/joyce33/p/13376752.html