运行 xcode-select --install 是安装命令行工具最直接方式，会弹窗引导安装；若失败可手动下载匹配 macOS 版本的 CLT 安装包；安装后须执行 xcode-select -p 确认路径并 sudo xcodebuild -license accept 接受许可。
运行
就能触发安装
这是最直接、最常用的方式。打开终端，输入
回车，系统会弹出图形化窗口，提示「无法找到软件包」并询问是否安装「命令行开发人员工具」——点「安装」即可。它会自动下载、解压、配置路径，全程无需手动找安装包。
注意：这个命令不会重复安装，如果已装好，会提示「command line tools are already installed」；但如果刚升级过 macOS（比如从 Sonoma 升到 Sequoia），即使之前装过，也建议再跑一次，因为新系统可能清空了旧路径注册。
不要等
或
报错才想起来装——很多工具（Homebrew、
、
）在 configure 阶段就依赖 CLT 的头文件和
，报错时往往已经卡在中间了
安装过程不显示进度条，但终端光标会暂停响应约 1–3 分钟（取决于网络和磁盘速度），别误以为卡死而强行退出
安装完成后，
应输出
手动下载安装包适用于网络受限或版本锁定场景
当
卡在「正在搜索软件包」或反复失败时，就得换手动方式。访问
Apple Developer Downloads
页面（需 Apple ID 登录），搜索
，选与你当前 macOS 版本严格匹配的版本。
例如：macOS Sequoia 15.4 对应的是
（不是 Xcode 15.4.app 本身）。下载后双击 .dmg → 运行 .pkg 安装器 → 按向导完成。
别用「App Store 下载完整 Xcode」来替代——虽然它也含 CLT，但体积大（>10GB）、启动慢，且默认不注册命令行路径，仍需额外执行
下载页面里同名但带「beta」字样的包，仅限开发者测试用，生产环境请避开
安装完务必验证：
和
都得有输出，否则 PATH 可能没生效（重启终端或
）
是路径切换开关，不是安装命令
如果你本地已装了完整版
（比如放在
），可以用
切换命令行工具指向它。但这**不等于安装 CLT**，只是告诉系统：“以后所有
、
、
都去这个目录下找”。
切换后必须运行
，否则多数命令会卡在 license 提示上
切回系统自带 CLT 路径：执行
误设路径导致
崩溃或
报
，大概率就是这里出问题了
装完必须做的两件事：确认路径 + 接受许可
很多人装完就以为万事大吉，结果几分钟后
失败、
找不到头文件、
卡住——八成是漏了这两步：
运行
再确认一次状态（即使刚装完）：它会检查注册是否完整，必要时修复符号链接
运行
：Xcode 工具链强制要求用户显式接受许可协议，跳过这步，
会静默失败，
可能拒绝操作
这两步没有顺序要求，但缺一不可。尤其当你在 CI 环境或新用户 shell 下配置时，很容易忽略许可这一步——它不报错，只让后续所有编译行为变得不可预测。
xcode-select --installxcode-select --installgcc --versiongit --versionmakecmakeclangxcode-select -p/Library/Developer/CommandLineToolsxcode-select --installCommand Line Tools for XcodeCommand Line Tools for Xcode 15.4sudo xcode-select -s /Applications/Xcode.app/Contents/Developerclang --versiongit --versionsource ~/.zshrcxcode-select -sXcode.app/Applications/Xcode.appsudo xcode-select -s /Applications/Xcode.app/Contents/Developerclangswiftcgitsudo xcodebuild -license acceptsudo xcode-select -s /Library/Developer/CommandLineToolsgitbrew installfatal error: 'stdio.h' file not foundbrew installmakeswift buildxcode-select --installsudo xcodebuild -license acceptclanggit