Homebrew公式リポジトリの問題点

Homebrewの公式サイト（https://brew.sh/zh-cn/）はGitHubを経由したソースを使用しており、国内環境でのダウンロード速度が遅くなる傾向があります。このため、国内ミラーサーバーを活用したインストールが推奨されます。

自動化スクリプトによるインストール

以下のコマンドを実行することで、Homebrewを効率的にセットアップできます。

curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh | zsh

手動インストール手順

Xcodeコマンドラインツールのインストールを確認します。

xcode-select --install

環境変数を設定します。Homebrew 4.0以降ではHOMEBREW_INSTALL_FROM_APIがデフォルト有効ですが、以下の設定を適用することで安定したインストールが可能です。

export HOMEBREW_API_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api"
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles"
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"

清华ミラーからHomebrewをダウンロードしてインストールします。

git clone --depth=1 https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/install.git brew-setup
bash brew-setup/install.sh
rm -rf brew-setup

Apple Siliconプロセッサ搭載macOS向け環境変数設定

[[ -f ~/.bash_profile ]] && echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.bash_profile || { touch ~/.bash_profile; echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.bash_profile; }
[[ -f ~/.zprofile ]] && echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile || { touch ~/.zprofile; echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile; }

エラー対応メモ

Xcodeコマンドラインツールダウンロード時のネットワーク切断エラーの場合、Apple公式ダウンロードページから直接dmgファイルを取得してください。

Git関連エラー（例: 'Rpc failed; curl 92 HTTP/2 stream 5 was not closed cleanly: CANCEL (err 8)'）が発生した場合は、.gitconfigに以下の設定を追加します。

[http]
  postBuffer = 1048576000
  maxRequestBuffer = 100M

brewコマンドが応答しない場合は、環境変数設定手順を再度実行してください。