macos 上只需安装「xcode command line tools」（约150–200mb）即可使用 xcodebuild、swift、clang、git 等工具；可通过终端触发安装、开发者网站下载或指向完整 xcode 路径三种方式安装，并需执行 xcode-select --install 和 sudo xcodebuild -license accept 完成配置。
macOS 系统上无需完整安装 Xcode IDE，即可使用其核心命令行工具（如 xcodebuild、swift、clang、git、make 等），只需单独安装「Xcode Command Line Tools」——它体积小（约 150–200MB）、安装快、不占桌面空间，且完全满足日常编译、脚本构建、Homebrew 安装、React Native / Flutter 开发等需求。
确认是否已安装命令行工具
打开终端（Terminal），执行：
xcode-select -p
若返回类似 /Library/Developer/CommandLineTools 的路径，说明已安装；若提示 error: invalid active developer path 或无输出，则需安装。
三种推荐安装方式（任选其一）
✅ 方式一：终端一键触发（最常用）
在终端中输入任意需要权限的开发命令，例如：
gcc --version 或 git --version
系统会自动弹出图形化提示框，点击「Install」即可下载安装。安装完成后，运行：
xcode-select --install
可手动唤起同一安装窗口（适用于未自动触发的情况）。
✅ 方式二：从 Apple 开发者网站手动下载（适合离线或旧系统）
访问 Apple Developer Downloads 页面（需 Apple ID 登录），搜索关键词 Command Line Tools for Xcode，选择与你 macOS 版本匹配的最新版（如 macOS Sonoma 14.5 对应 CLT 14.3.1）。下载后双击 .pkg 文件按向导安装。
✅ 方式三：通过 xcode-select 指定路径（高级用户）
如果你已安装完整版 Xcode.app（比如放在 Applications 目录下），可跳过单独安装 CLT，直接让命令行工具指向它：
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
然后运行：xcodebuild -license accept 接受许可协议。
安装后必要配置步骤
安装完成后，请务必执行以下两步，否则部分工具（如 Git、Swift 包管理器）可能异常：
- 运行
xcode-select --install确认状态（即使刚装完也建议再执行一次） - 运行
sudo xcodebuild -license accept接受许可证（若提示未同意） - 验证是否生效：
clang --version、swift --version、git --version均应正常输出版本号
常见问题快速排查
问题：安装后仍提示 “command not found”
→ 检查终端是否重启（新 Shell 进程才加载 PATH）；或手动刷新环境：source ~/.zshrc（macOS Catalina 及以后默认用 zsh）。
问题：Homebrew 报错 “no developer tools installed”
→ 执行 xcode-select -r 重置路径，再运行 xcode-select --install 重新安装。
问题：CLT 升级后 git 提交失败或签名异常
→ 可能因钥匙串权限变更，执行：git config --global credential.helper osxkeychain 并重新存入凭据。
