如何重置XCode项目的Git及.gitignore至默认配置

我之前帮好几个iOS团队处理过完全一样的问题——手动修改XCode提交面板的文件规则，不小心把CocoaPods管理的依赖库提交到Git，结果推送后团队成员拉取代码要么缺文件，要么本地文件冲突，简直头大。别担心，按下面的步骤一步步来，就能彻底重置Git状态，把问题解决掉：

第一步：先做本地备份（重中之重） #

先把整个项目文件夹复制一份到电脑的其他位置，万一操作过程中出了岔子，还能快速恢复。毕竟涉及到Git仓库的重置，谨慎点总没错。

第二步：切换到最新分支并拉取最新代码 #

确保你当前在团队的主分支（比如main或者develop）上，执行命令：

git checkout main
git pull

这样能保证你基于最新的代码进行修改。

第三步：从Git仓库中移除误提交的CocoaPods依赖 #

我们要把已经提交到Git里的Pods/目录从仓库中移除，但保留本地的Pods文件夹（毕竟你本地开发还需要用这些依赖）。执行以下命令：

git rm -r --cached Pods/

如果还有其他误提交的CocoaPods相关文件（比如某个单独的.framework文件），也用同样的命令移除，比如：

git rm --cached SomeThirdPartyPod.framework

完成后提交这个移除操作：

git commit -m "Remove accidentally committed CocoaPods dependencies from Git repository"

第四步：重置并配置正确的.gitignore #

先把旧的.gitignore备份一下，防止有用的规则丢失：

mv .gitignore .gitignore.old

然后创建新的.gitignore文件，添加针对iOS项目和CocoaPods的核心忽略规则：

# CocoaPods 依赖目录，必须忽略
Pods/

# 如果你团队希望统一依赖版本，可以保留 Podfile.lock 的提交；如果依赖版本经常变动，也可以加上下面这行注释
# Podfile.lock

# XCode 本地配置文件，避免团队间冲突
*.xcuserdata/
*.xccheckout
*.xcuserstate

把新的.gitignore提交到仓库：

git add .gitignore
git commit -m "Update .gitignore to properly exclude CocoaPods dependencies and local XCode configs"

第五步：推送修改到远程仓库 #

现在把你的修改推送到远程主分支：

git push origin main

第六步：告知团队成员同步操作 #

让团队里的所有人都执行以下步骤，确保本地环境同步：

• 先把本地未提交的修改 stash 或者提交：git stash（之后可以用git stash pop恢复）
• 拉取最新代码：git pull
• 删除本地的旧Pods目录：rm -rf Pods/
• 重新安装依赖：pod install
• 之后就可以正常进行Git协作了

关键注意事项 #

• 以后绝对不要再通过XCode的提交面板手动修改文件的包含/忽略状态，所有规则都要通过.gitignore来管理，这样团队的配置才能统一。
• 每次新增依赖或者修改Podfile后，只提交Podfile和Podfile.lock（如果团队约定提交的话），绝对不要提交Pods/目录。

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