>

用 xcodebuild 在终端编译 Xcode 工程

按 scheme 和配置编译应用，无需打开 Xcode 界面。

macOSxcodebuild 项目构建构建开发低风险
运行 xcodebuild -project MyApp.xcodeproj -scheme MyApp -configuration Debug build 即可在命令行编译。

01命令

命令
$ xcodebuild -project MyApp.xcodeproj -scheme MyApp -configuration Debug build

02作用说明

xcodebuild 调用的是与 Xcode 界面完全相同的构建系统，因此是 CI 流水线和脚本化构建的基础。先用 xcodebuild -list 查看可用的 scheme，因为 -scheme 名称必须完全一致。产物默认放在 DerivedData 目录，可用 -showBuildSettings 或 -derivedDataPath 控制输出位置。

03风险

风险低风险
使用条件Xcode or Command Line Tools installed; a valid .xcodeproj or -workspace for CocoaPods projects.
!注意: 如果工程使用了 CocoaPods 依赖，必须改用 -workspace X.xcworkspace 而不是 -project，否则会报错；在 IDE 之外常见的代码签名失败，本地测试构建可加 CODE_SIGNING_ALLOWED=NO 跳过。

04撤销

撤销
$ xcodebuild -project MyApp.xcodeproj -scheme MyApp clean

05来源

  • xcodebuild(1) macOS Manual Page
    Apple man pages (mirror) · vendor-doc · 2026-09-17
    依据: Documents xcodebuild -project/-scheme/-configuration and the build and clean actions.

最后验证: 2026-09-18 · 分类: 开发者

06相关方案

获取精确的 macOS 版本号与 Build 号
macOSsysctl 内核参数构建sw_vers 系统版本

sw_vers 与 uname 一行命令给出准确的系统版本、Build 号和内核架构。

低风险 ✓ 2026-09-17