使用xcodebuild docbuild生成DocC文档失败，如何排除指定模块？

方法1：修改Scheme跳过目标构建 #

• 打开Xcode，点击顶部Scheme下拉框选择「Edit Scheme」
• 切换到Build标签页，找到NotificationServiceExtension目标，取消它的Build勾选框
• 保存Scheme后再执行你的xcodebuild docbuild命令，就能跳过这个模块的构建

方法2：直接指定主目标构建 #

不用依赖整个Scheme，直接在命令里指定要构建的主模块目标，这样不会触发扩展模块的构建：

xcodebuild docbuild -sdk iphoneos -project MyProject.xcodeproj -target MyProject -derivedDataPath ~/Desktop/MyProjectDocC

方法3：通过构建参数跳过扩展模块安装 #

在原命令后添加参数，强制跳过扩展模块的安装流程，避免构建报错：

xcodebuild docbuild -sdk iphoneos -project MyProject.xcodeproj -scheme MyProject -derivedDataPath ~/Desktop/MyProjectDocC NotificationServiceExtension_SKIP_INSTALL=YES

额外排查点 #

既然Xcode GUI能正常构建，命令行模式失败，还可以检查以下配置：

• 查看NotificationServiceExtension的Build Settings，确认Documentation Compiler相关配置（比如DOCC_EXCLUDE_SOURCE_FILES）是否正确
• 检查该模块的Swift版本、依赖库是否和主项目一致，命令行环境可能读取到不同的默认配置

内容的提问来源于stack exchange，提问作者Mehrdad