必须安装Xcode命令行工具才能运行git、make等开发命令;推荐终端执行xcode-select --install一键安装;网络受限时可从Apple官网下载匹配系统版本的安装包;已装Xcode者需用sudo xcode-select --switch指定路径并接受许可协议。

你在Mac上运行git、make、gcc或Homebrew时提示“command line tools are not installed”,说明系统缺少Xcode命令行开发工具,必须安装后才能编译C/C++程序、执行自动化构建或使用多数开源开发依赖。
终端一键触发安装(推荐新手)
这一步操作起来很简单,直接在终端里敲一条命令就能唤起系统原生安装流程,全程图形化引导,无需登录Apple ID,也不依赖完整Xcode。
第一步:按 Command + 空格 打开聚焦搜索,输入「终端」并回车启动。
第二步:在终端中输入以下命令并回车:xcode-select --install。
第三步:系统弹出窗口显示“无法找到软件包”,点击【安装】按钮→阅读许可协议→勾选【同意】→等待自动下载与部署完成。
【注意:安装过程中不要关闭窗口或中断网络,否则可能卡在半途导致路径损坏】
从Apple开发者官网手动下载(适用于网络受限或旧系统)
当终端命令无响应、弹窗被MDM策略屏蔽、或你正使用已停止支持的macOS版本(如macOS Monterey 12.6),必须通过官网获取精确匹配的安装包。
方法一:访问 https://www.php.cn/link/ee48b036c553073e2d4ac9828ee87625,用Apple ID登录(未注册可免费开通)。
方法二:在页面顶部搜索框输入 Command Line Tools for Xcode,筛选与你当前系统完全一致的条目——例如 macOS Sequoia 15.0 对应的是 Command Line Tools for Xcode 15.4,不能选15.3或15.5。
方法三:点击右侧下载链接,保存 .dmg 文件到「下载」文件夹→双击挂载→运行其中的 Command_Line_Tools_for_Xcode_*.pkg 安装包→按向导点击继续直至完成。
已装完整Xcode时快速启用(高级用户适用)
如果你已通过App Store安装了Xcode.app(体积约12GB),就不必重复安装轻量版命令行工具,只需两步将其激活为默认工具链。
打开终端,依次执行:
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
sudo xcodebuild -license accept
第一条命令将系统命令行工具路径强制指向Xcode内置目录;第二条是接受Xcode许可协议,【缺少这步会导致xcodebuild、swiftc等命令拒绝运行】。











