如何实现不同Xcode项目向同一GitHub仓库提交代码完成协作

核心问题排查 #

你遇到的仅原始创建项目可提交的问题，90%以上是仓库权限未配置或队友端项目初始化流程有误，按以下步骤操作即可正常协作： #

1. 配置GitHub仓库协作权限 #

• 打开项目对应的GitHub仓库页面，进入Settings → Collaborators设置项
• 点击Add people按钮，输入队友的GitHub用户名或绑定邮箱，发送协作邀请
• 队友登录GitHub账号接受邀请后，即可获得仓库的读写权限，无权限的情况下仅能拉取代码无法提交

2. 队友端项目初始化正确流程 #

禁止直接下载Zip包、或新建Xcode项目后导入代码，必须走Git克隆流程：

• 打开终端，切换到本地存储项目的目录，执行命令：git clone 你的GitHub仓库HTTPS/SSH地址
• 克隆完成后，直接用Xcode打开本地项目目录下的.xcodeproj或.xcworkspace文件即可
• 首次提交前先配置本地Git身份信息，终端执行以下两条命令（信息和队友自己的GitHub账号保持一致）：

git config user.name "GitHub用户名"
git config user.email "GitHub绑定邮箱"

小提示：如果用SSH地址克隆仓库，队友需要提前在自己的GitHub账号设置中添加本地生成的SSH公钥，可避免每次提交都需要输入账号密码，也不会触发权限校验报错

3. 日常协作标准流程 #

• 每次开始写代码前，先执行git pull拉取远程仓库的最新代码，避免后续出现提交冲突
• 代码改动完成后，可直接在Xcode顶部菜单栏的Source Control面板中勾选要提交的改动，填写提交说明后完成本地提交
• 本地提交完成后，选择Push即可将改动同步到远程GitHub仓库，其他队友拉取即可拿到最新代码

4. 常见报错处理 #

• 提交提示权限不足：先确认队友已接受协作邀请，且本地Git配置的用户名、邮箱和GitHub账号信息完全匹配
• 提交提示代码冲突：在Xcode弹出的冲突对比面板中，手动选择要保留的代码版本，解决所有冲突后再重新提交推送即可

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