如何将现有Xcode Git仓库迁移至GitLab（无需删除项目或重新初始化）

不用删除本地Xcode项目或重新初始化Git仓库，通过命令行即可完成同步，步骤如下：

1. 在GitLab创建空白仓库 #

• 登录GitLab后台，点击「New project」，选择「Create blank project」
• 填写与本地Xcode项目匹配的项目名称，务必取消勾选「Initialize repository with a README」「Add .gitignore」「Add a license」这三个选项，直接完成仓库创建
• 创建后复制仓库的HTTPS或SSH地址，后续会用到

2. 定位到本地Xcode项目的Git目录 #

• 打开Xcode项目，右键项目根文件，选择「Show in Finder」
• 在Finder中右键项目文件夹，选择「New Terminal at Folder」，快速打开终端并定位到项目目录
• 也可以手动用cd命令切换目录，比如：cd ~/Documents/MyiOSProject

3. 添加GitLab作为远程仓库 #

• 先查看当前已有的远程仓库，确认原仓库状态：

  git remote -v
  

• 添加GitLab远程仓库（这里命名为gitlab，可自定义）：

  git remote add gitlab <你复制的GitLab仓库地址>
  

• 再次执行git remote -v，确认gitlab远程已成功添加

4. 推送本地代码到GitLab #

• 推送所有本地分支到GitLab：

  git push --all gitlab
  

• 如果本地有标签需要同步，执行：

  git push --tags gitlab
  

5. 在Xcode中管理GitLab远程（可选） #

• 打开Xcode的「Source Control」菜单，选择「[你的项目名] > Configure [项目名]...」
• 在弹出窗口切换到「Remotes」标签，就能看到刚添加的gitlab远程，可直接在这里执行推送、拉取操作

注意事项 #

• 如果使用SSH地址推送，需确保本地SSH公钥已添加到GitLab的个人设置中
• 如果使用HTTPS地址，推送时可能需要输入GitLab账号密码，推荐使用GitLab个人访问令牌替代密码

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