M系列芯片Mac安装Homebrew配置笔记

M系列芯片Mac安装Homebrew配置笔记

核心原理

• Homebrew：macOS的包管理器，用于安装开发工具和常用软件。
• 关键路径：M芯片Mac安装路径为 /opt/homebrew（Intel芯片为 /usr/local）。
• 镜像加速：使用国内镜像源（如清华、中科大）解决GitHub下载慢的问题。

---

第一步：安装Xcode Command Line Tools（基础依赖）

作用：提供git、clang等编译工具，是Homebrew的底层依赖。

xcode-select --install

验证：弹出软件更新窗口，点击“安装”即可。安装完成后可运行 xcode-select -p 查看路径。

---

第二步：安装Homebrew（使用国内镜像加速）

核心思路：先设置镜像环境变量，再运行官方脚本，让安装过程自动走国内源。

方案A：清华源安装（推荐，步骤清晰）

# 1. 设置镜像环境变量（临时生效，仅限当前终端窗口）
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"
export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git"

# 2. 运行官方安装脚本
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

方案B：中科大源安装（备用，一键完成）
如果清华源遇到问题，可使用中科大提供的打包脚本：

/bin/bash -c "$(curl -fsSL https://mirrors.ustc.edu.cn/misc/brew-install.sh)"

安装过程：

• 脚本会提示需要管理员密码（输入时密码不显示，回车即可）。
• 首次安装需从镜像站克隆核心仓库（约300MB），网络通畅时约需5-15分钟，请耐心等待进度完成。
• 看到 ==> Installation successful! 即安装成功。

---

第三步：配置环境变量（最关键步骤）

问题：安装后直接运行 brew 会提示 command not found，因为路径未添加到系统环境。

解决方法：执行安装完成后终端提示的命令（以下命令针对 M芯片Mac，路径为 /opt/homebrew）。

# 1. 将brew的初始化命令添加到shell配置文件
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc

# 2. 立即在当前终端生效
eval "$(/opt/homebrew/bin/brew shellenv)"

# 3. 将国内镜像配置也永久写入配置文件，确保后续使用加速
echo 'export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"' >> ~/.zshrc
echo 'export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git"' >> ~/.zshrc

# 4. 使镜像配置立即生效
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"
export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git"

---

第四步：验证与测试

逐条运行以下命令进行“开机自检”：

# 1. 验证命令是否可用（显示版本号即成功）
brew --version

# 2. 更新Homebrew自身（测试网络和镜像连接）
brew update

# 3. 运行诊断（检查系统环境）
brew doctor

# 4. 安装一个测试程序（验证完整安装流程）
brew install hello
hello  # 运行后应输出 "Hello, World!"

---

第五步：后续使用与维护

1. 安装软件：
   • 命令行工具：brew install git node python
   • 图形应用：brew install --cask visual-studio-code google-chrome
2. 日常维护：

   brew update     # 更新Homebrew自身和软件列表
   brew upgrade    # 升级所有已安装的软件包
   brew cleanup    # 清理旧版本缓存
   

3. 故障排查：
   • 始终确保 ~/.zshrc 中有正确的 eval "$(/opt/homebrew/bin/brew shellenv)" 行。
   • 镜像失效时，可重新执行第三步的镜像配置命令。
   • 彻底重装：sudo rm -rf /opt/homebrew 后从第一步开始。

---

配置摘要表

步骤	核心命令/文件	作用	验证方法
1. 装CLT	xcode-select --install	安装基础编译工具	xcode-select -p 输出路径
2. 装Brew	方案A或B的 curl 命令	安装Homebrew本体	出现 Installation successful!
3. 配路径	~/.zshrc 中的 eval 行	让系统找到 brew 命令	brew --version 显示版本
4. 配镜像	~/.zshrc 中的 export 行	加速下载	brew update 速度快且无报错
5. 验功能	brew install hello	测试完整流程	运行 hello 输出问候语