Xcode重命名结构体后Xcode Cloud构建失败，如何解决？

• 核对Git提交的文件名大小写：macOS默认不区分文件名大小写，但Git和Xcode Cloud构建环境是严格区分的。如果重命名时只改了大小写（比如oldView.swift改成OldView.swift），Git可能没识别到变更，仓库里还是旧文件名。用git ls-files命令查看仓库内实际文件名，或者直接在远程仓库确认。如果是这个问题，执行git mv 旧文件名 新文件名提交变更后推送到远程。
• 清除Xcode Cloud构建缓存：Xcode Cloud可能缓存了旧的索引或构建产物，没读取到最新的文件变更。在Xcode的Report Navigator里找到对应工作流，点击右上角...选择Clean；或者登录Apple Developer网站的Xcode Cloud控制台，重置该工作流的缓存。
• 检查所有引用的导入语句：重命名结构体后，确认所有用到它的文件里的导入路径是否正确。比如视图属于子模块的话，有没有因为重命名导致模块路径变化？本地索引缓存可能掩盖了这个问题，但CI是全新构建会暴露。
• 验证工作流的Scheme配置：确认Xcode Cloud使用的Scheme是否勾选了包含该视图的Target，同时检查Scheme的Build Configuration（Debug/Release）是否和本地一致。有时候CI用Release配置，本地用Debug，配置差异可能导致文件没被纳入构建。
• 排查文件路径与.gitignore规则：检查该文件的相对路径是否含特殊字符，再核对.gitignore有没有意外匹配到该文件的规则（比如*View.swift这类模糊匹配）。另外，查看文件的编译选项，是否有-exclude-from-build标记导致CI跳过编译。
• 查看完整构建日志：只看错误提示不够，拉取Xcode Cloud的完整构建日志，搜索该结构体名称，找文件找不到的具体路径信息，或者是否有其他前置编译错误导致索引失败。
• 本地模拟CI构建流程：在本地执行xcodebuild clean build命令，模拟CI的无缓存构建。如果本地用这个命令也能复现问题，说明是项目配置问题，而非Xcode Cloud本身的问题，方便后续排查。

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