使用Git+Xcode开发KMP项目：是否需提交project.pbxproj至GitHub？

是否需要提交project.pbxproj的变更？ #

必须提交，而且要确保每次修改后都同步到远端仓库。

此举的必要性 #

project.pbxproj是Xcode项目的核心配置文件，里面记录了：

• 项目包含的所有文件引用（包括KMP共享模块在iOS端的关联文件）
• 各个target的编译配置（SDK版本、编译选项、签名设置等）
• 依赖关系（比如KMP项目中iOS对共享代码的依赖）
• 资源文件的打包规则

对于KMP项目来说，这个文件还维系着iOS端和跨平台模块的关联逻辑，团队协作时如果不同步这个文件，每个人的Xcode项目结构都会脱节。

不提交的后果 #

• 团队成员拉取代码后，Xcode打开项目会直接报错，比如找不到target、缺失文件引用，甚至无法正常加载项目
• KMP的iOS端编译会失败，因为跨平台模块的关联配置没同步
• 你新增的文件、修改的编译参数不会被其他人看到，导致本地能正常编译，别人的环境却报错，出现“在我这没问题”的协作噩梦
• 长期不提交会积累大量配置差异，后续合并时会出现复杂的冲突，很难修复

不提交是否会导致文件无法同步或被识别？ #

绝对会。project.pbxproj是Xcode识别项目文件的依据：

• 你新增的文件如果没更新这个配置，其他人拉取代码后，文件会出现在本地目录，但不会显示在Xcode的项目导航栏里，Xcode编译时也不会把它纳入打包范围
• VCS层面虽然文件存在，但Xcode不认为它是项目的一部分，会出现“文件未被添加到项目”的警告或报错
• 涉及KMP共享模块的文件引用如果没同步，会直接导致iOS端找不到跨平台代码，编译失败

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