关键不是统一安装所有工具，而是按语言生态分层隔离：Python用pyenv+venv管理解释器与项目依赖，PHP用Homebrew+Composer，iOS用Homebrew Ruby+CocoaPods，Java用Homebrew JDK+Maven镜像，各层职责分明。
管理 macOS 存储库的资源依赖关系，关键不是“统一安装所有工具”，而是按语言生态分层控制：解释器版本、项目依赖、底层动态库三者必须隔离，否则容易出现 dyld: Library not loaded、ImportError 或 ABI 不兼容崩溃。
Python 项目：用 pyenv + venv 分层隔离
系统自带 Python 和 Homebrew 安装的 Python 都不建议直接使用。正确做法是：
- 用 pyenv 管理 Python 版本：安装后在
~/.zshrc中配置 shims，确保which python指向~/.pyenv/shims/python - 按项目运行
python -m venv .venv创建独立环境，再source .venv/bin/activate激活 - 配合 direnv 可实现进入目录自动激活、离开自动退出，避免手动切换遗漏
PHP 项目：Composer + Homebrew PHP 组合使用
不要用系统内置 PHP（已弃用），也不要直接下载 phar 文件调用。稳定方案是：
- 通过 Homebrew 安装指定版本 PHP：
brew install php@8.3，确认php -v和php -m | grep openssl正常 - 全局安装 Composer：
curl -sS https://getcomposer.org/installer | php -- --install-dir=/opt/homebrew/bin --filename=composer - 设阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
iOS 开发：CocoaPods 依赖需绕过系统 Ruby
macOS 内置 Ruby 受 SIP 保护，gem 安装易失败。应：
- 用 Homebrew 安装 Ruby：
brew install ruby，并把/opt/homebrew/bin加入PATH - 验证
which ruby输出路径含/opt/homebrew/bin，再执行gem install cocoapods - 在 Xcode 项目根目录运行
pod init编辑 Podfile，然后pod install——务必用生成的.xcworkspace打开项目
Java/Maven 项目：镜像加速 + 环境解耦
Maven 本身不处理 JDK，但依赖 JDK 路径稳定。推荐：
- Homebrew 安装 JDK 和 Maven：
brew install openjdk@21 maven，brew 会自动注入环境变量 - 编辑
~/.m2/settings.xml，在<mirrors>块中添加阿里云 Maven 镜像配置 - 避免手动设置
MAVEN_HOME或修改PATH，交由 brew 管理更可靠
依赖冲突本质是路径、符号或加载顺序错乱，不是装得不够多，而是没分清“谁管版本”、“谁管包”、“谁管 dylib”。每层各司其职，问题就清晰可解。
