必须手动确认Xcode许可协议,否则xcodebuild等核心工具报错,Flutter等依赖编译的工具无法运行;因苹果将许可强制绑定至Xcode整体,即使仅安装命令行工具也需同意。
安装 xcode 或其命令行工具后,必须手动确认许可协议,否则 xcodebuild、clang、swift 等核心工具会报错退出,flutter、cocoapods、homebrew 等依赖编译的工具也无法正常运行。
为什么必须确认许可协议?
苹果将 Xcode 的使用条款以法律协议形式强制绑定——即使只装了命令行工具(约 180MB),系统仍视作接受 Xcode 整体许可。未确认时,终端执行任何开发相关命令(如 flutter build ios 或 pod install)都会提示:xcrun: error: active developer path ... does not exist 或 Agreeing to the Xcode/iOS license requires admin privileges。
如何快速完成确认?
打开终端,运行以下命令:
sudo xcodebuild -license
随后按提示操作:
- 回车键翻页阅读协议(或直接按
q跳过) - 看到
agree/print/cancel提示时,输入agree并回车
成功后无输出即表示完成。无需重启终端或重装工具。
常见异常与应对
-
提示 “command not found”:说明命令行工具未安装,先运行
xcode-select --install安装后再执行许可确认 -
返回路径错误(如 /Library/Developer/CommandLineTools)但许可仍不生效:运行
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer(若已装完整版 Xcode),再重试许可命令 - 权限拒绝或密码不生效:确保当前用户是管理员;若用企业管控 Mac,可能需联系 IT 启用开发者权限
这一步不耗时,但跳过就会卡住后续所有开发流程。确认一次,长期有效,除非重装系统或彻底删除 Xcode 相关组件。


















