开启项目版本控制的第一步
在Xcode中管理代码版本其实不需要安装额外软件，内置的Git工具已经非常成熟。打开你的项目后，点击顶部菜单栏的File，选择Source Control，然后点击Define Git Repository。如果项目文件夹里之前没有初始化过版本库，这一步会自动为你创建隐藏文件夹并建立初始分支。你会发现左侧导航栏的项目图标旁边多了一个绿色的对勾，代表当前所有文件都已提交且处于干净状态。如果看到黄色感叹号，说明有文件被修改但还没保存提交，双击黄色标记可以直接打开变更窗口。
日常开发中最常用的提交操作
每天写代码时，养成随时提交的习惯是避免代码丢失的关键。写完一段逻辑后，点击左上角的绿色对勾按钮，或者按快捷键Command加Option加K，会弹出提交窗口。在右侧的文件列表里勾选你本次修改过的文件，在中间的输入框写上简短明确的提交信息，比如修复登录页闪退或者新增首页轮播图，最后点击Commit即可。提交成功后，该文件旁边的黄色标记会变成绿色，表示已安全存档到本地数据库。注意不要一次性把所有无关文件都塞进去，保持提交记录清晰能大幅降低后期排查问题的成本。
查看历史与对比差异
有时候改着改着发现新逻辑跑不通，想回退到昨天的状态，这时候需要用到历史记录功能。点击菜单栏的Window下的Source Control History，或者直接用快捷键Command加Shift加G，就能打开版本记录面板。左侧是按时间排列的每一次提交，中间显示提交人、时间和备注，右侧则是具体改了哪些文件。选中任意两条记录，点击下方的Compare Selected Commits，Xcode会直接打开左右分屏的Diff视图，红色代表删除，绿色代表新增，让你一眼看清代码变动轨迹。如果发现某次提交引入了严重Bug，可以右键该记录选择Revert to Here，系统会自动生成一条反向提交来撤销改动。
分支管理与合并技巧
多人协作或者开发新功能时，主分支绝对不能随便动。点击菜单栏Source Control，选择Checkout New Branch，输入分支名称如feature-login-page，Xcode就会自动基于当前代码创建一个新分支并切换过去。在新分支上放心折腾，等测试没问题后，切回Master或Main分支，再次进入Source Control菜单，选择Merge into Current Branch，把功能分支拉过来合并。如果有冲突，Xcode会在对应代码行标出红色警告，手动选择保留本地还是接受对方改动，解决完点击Continue完成合并。合并过程中千万不要强制覆盖，耐心处理每一处冲突才能保证项目稳定运行。
连接远程仓库与推送同步
本地提交只是第一步，真正的安全备份需要推送到GitHub或GitLab等远程服务器。首次使用前，需要在Source Control菜单里选择Configure Repositories，然后Add Repository，粘贴你的远程仓库地址。配置完成后，点击Push按钮，输入账号密码或使用SSH密钥验证，代码就会上传到云端。后续每次本地提交后，只需点一下Push就能保持两端一致。如果遇到Push失败提示权限问题，通常是Token过期或分支保护策略限制，去远程平台检查设置即可恢复。建议定期Pull最新代码再开始工作，避免本地版本落后导致后续合并困难。
常见问题排查建议
使用内置Git时偶尔会遇到状态不同步的情况，比如明明提交了却还显示黄色标记。这时候可以尝试在终端里cd进入项目根目录，执行git status命令核对底层状态，然后在Xcode里右键点击项目选择Source Control中的Refresh。另外，大型项目频繁更新会导致Xcode缓存变慢，建议在Preferences的General里适当调整索引优先级，或者定期清理DerivedData缓存文件夹。掌握这些基础操作后，你完全可以脱离命令行，在图形界面里高效完成整个版本控制流程。遇到复杂场景时结合官方文档查阅具体参数，能让团队协作更加顺畅。
