Xcode 13.1为已上线旧项目创建Git仓库提示已存在但无内容无法操作

步骤1：校验本地Git仓库状态 #

先关闭Xcode，打开终端进入你的项目根目录，执行命令：
ls -a
如果输出结果中包含.git文件夹，说明仓库已经实际创建完成，仅为Xcode识别异常；如果没有该文件夹，手动执行初始化命令：
git init

步骤2：配置Git基础信息 #

在项目根目录依次执行以下命令，配置提交身份信息：

git config user.name "你的Git用户名"
git config user.email "你的Git绑定邮箱"

步骤3：完成首次代码提交 #

先创建.gitignore文件过滤不需要提交的Xcode缓存、临时文件：
touch .gitignore
写入Xcode通用忽略规则后，执行首次提交：

git add .
git commit -m "初始化仓库：同步当前线上版本代码"

步骤4：强制Xcode识别仓库 #

重启Xcode打开项目，按顺序操作：

• 顶部菜单栏选择 Source Control → Refresh Local Status
• 进入Xcode偏好设置的Source Control栏目，确认Enable Source Control选项已勾选
  此时查看Source Control标签页，即可正常显示提交记录、分支等信息。

异常兼容处理 #

如果完成以上操作后Xcode仍不识别仓库，直接删除项目根目录下的xcuserdata文件夹（该文件夹仅存储本地Xcode操作缓存，不会影响项目编译逻辑与上线功能），再重启Xcode即可恢复正常。

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