Homebrew 是 macOS 上最常用的开发工具包管理器。它解决了命令行工具安装、升级和依赖管理问题，但也需要理解路径、架构和版本隔离。

1. 学习目标

• 掌握 Homebrew、Xcode Command Line Tools、PATH 和 shell 配置。
• 理解 Apple Silicon 上 /opt/homebrew 与 Intel 上 /usr/local 的差异。
• 能排查命令找不到、依赖冲突和多版本工具问题。

2. 知识框架

Homebrew与开发环境
├─ 入门：建立术语、对象和日常操作的直觉
├─ 进阶：理解机制、边界和跨平台差异
└─ 专家：能排障、能设计、能阅读实现和研究材料

macOS 开发环境通常由系统工具、Xcode CLT、Homebrew、语言版本管理器和项目依赖共同组成。

3. 核心概念

主题	说明	工程关注
Xcode CLT	编译器、git、make 等基础开发工具	安装编译依赖前置条件
Homebrew formula	命令行工具和库的安装配方	brew install/upgrade
Cask	图形应用安装方式	浏览器、IDE、客户端工具
PATH	Shell 查找命令的目录顺序	多版本冲突、命令找不到

4. 机制与实践

1. 新机器先安装 CLT，再安装 Homebrew 和语言工具链。
2. 用 brew doctor 定期检查环境异常。
3. 项目级语言版本用 asdf、jenv、nvm、pyenv 等工具隔离。

5. 常用命令与工具

命令或工具	作用	使用建议
xcode-select --install	安装命令行工具	新机器开发前置步骤
brew doctor	检查 Homebrew 环境	定位路径和权限问题
brew info package	查看包信息	确认版本、依赖和安装路径

6. 常见误区

• 混用 arm64 和 x86_64 brew：会造成依赖路径和二进制架构混乱。
• 用 sudo 修 Homebrew 权限：Homebrew 不建议以 root 管理普通包，可能引入权限问题。
• 全局安装过多语言依赖：不同项目版本冲突，应该用项目级版本管理。

7. 进阶研究方向

• 研究 Homebrew Cellar、opt 链接和 formula 机制。
• 了解 Rosetta shell 与原生 arm64 shell 的差异。
• 沉淀团队 macOS 开发环境初始化脚本。

8. Tips 快问快答

Q：brew install 和 brew install --cask 区别是什么？

A：前者主要安装命令行工具和库，后者主要安装图形应用。

Q：Apple Silicon 的 Homebrew 默认在哪？

A：通常在 /opt/homebrew，Intel macOS 通常在 /usr/local。

Q：命令找不到怎么排查？

A：检查是否安装、PATH 顺序、Shell 配置是否加载以及当前终端架构。

9. 总结

macOS 开发体验很大程度取决于工具链治理。Homebrew 很强，但要配合架构、PATH 和项目版本管理一起使用。