xcode command line tools是macos系统级开发核心组件，体积约1gb，含clang、git、make、sdk头文件等，需执行xcode-select --install安装并用clang --version验证。
macos 系统级别的开发组件，不是普通应用，而是支撑整个开发流程的底层能力——比如编译器、调试器、系统头文件、签名工具、内核扩展支持等。它们不直接出现在 launchpad 里，但缺了就跑不了 xcode、编译 rust、构建 swift 包，甚至执行 make 或 clang 都会报错。
必须安装的系统级组件：Xcode Command Line Tools
这是最核心、也最容易被跳过的一步。它和完整版 Xcode 不同：体积小（约 1GB）、无 GUI、纯命令行工具集，但包含了 clang、git（系统自带 Git 的增强版）、make、libtool、pkgutil 和 macOS SDK 头文件等。
- 终端运行：
xcode-select --install，弹窗确认即可 - 验证是否成功：
clang --version或git --version应返回版本信息 - 如果已装过完整 Xcode，仍需单独运行该命令——因为 Xcode 默认不自动启用 CLI 工具路径
- 若提示“command line tools are already installed”，但
clang找不到，运行xcode-select --reset重置路径
系统级依赖管理：Homebrew + Apple Silicon 兼容性处理
Homebrew 本身是用户级程序，但它安装的许多工具（如 openssl、readline、zlib）会被系统级构建过程调用。Apple Silicon（M1/M2/M3）Mac 必须注意架构隔离问题。
- 安装 Homebrew 后，它默认使用
/opt/homebrew（ARM64），而非旧式/usr/local - 确保 shell 配置（如
~/.zshrc）中已加入：export PATH="/opt/homebrew/bin:$PATH" - 某些老项目依赖 Intel 架构工具（如部分 Python C 扩展），可临时用 Rosetta 运行 Terminal，或通过
arch -x86_64 brew install xxx安装 x86_64 版本 - 避免混用不同架构的
brew和系统工具，否则常见报错：ld: library not found for -lSystem
系统权限与安全配置：开发者模式与全盘访问
从 macOS Monterey（12.0）起，部分开发行为需要显式授权，尤其是涉及进程注入、调试、网络抓包或读取系统日志的操作。
- 启用“开发者模式”：系统设置 → 隐私与安全性 → 滚动到底部，点击“启用开发者模式”（需输入密码）
- 授予终端“完全磁盘访问”权限：系统设置 → 隐私与安全性 → 完全磁盘访问 → 点“+”，添加
/Applications/Utilities/Terminal.app或你常用的终端（如 iTerm2） - 若使用 LLDB 调试或 Instruments 分析，还需在“辅助功能”中添加对应工具
- 未授权时常见现象：
process launch failed: unable to attach或Operation not permitted
系统级环境补丁：SDK 路径、符号链接与默认工具链
macOS 自带的 /usr/bin/python、/usr/bin/git 等是只读系统路径，不能升级；而开发中常需新版工具。正确做法是让系统“知道”优先用你装的版本。
- 确认当前 SDK 路径：
xcode-select -p应指向/Applications/Xcode.app/Contents/Developer或 CLI 工具路径 - 不要手动删除
/usr/bin下的链接，而应通过brew link --force xxx建立用户级软链（如brew link python会把python3链到/opt/homebrew/bin/python3） - 如需全局替换
git，用brew install git后，在~/.zshrc中确保/opt/homebrew/bin在$PATH最前面 - 检查
CC、CXX环境变量是否指向正确编译器：echo $CC应为clang或/opt/homebrew/bin/clang（非必要时不建议改）
