Git：远程仓库配置（Github + Gitee 同步托管）

1. 场景描述

本地已有从 Gitee 克隆的代码，现在需要将代码同时托管到 GitHub 和 Gitee，并保持两者同步，且不丢失历史记录。

2. 核心逻辑

Git 允许一个本地仓库关联多个远程仓库（Remote）。我们只需通过 git remote 命令管理不同的上游地址即可。

3. 操作步骤

Step 1: 准备空白 GitHub 仓库

在 GitHub 新建仓库，切勿勾选 “Initialize with README”，保持仓库完全空白。

Step 2: 切换当前 origin 到 GitHub

由于克隆下来的项目默认 origin 指向 Gitee，我们先将其迁移至 GitHub。

# 修改 origin 的指向
git remote set-url origin https://github.com/YourName/RuoYi-Vue.git

# 统一分支名为 main (GitHub 默认)
git branch -M main

# 建立关联并推送
git push -u origin main

Step 3: 添加 Gitee 仓库为第二远程

不修改现有的 origin，而是新增一个名为 gitee 的远程分支。

# 添加新远程仓库
git remote add gitee git@gitee.com:YourName/RuoYi-Vue.git

# 验证当前远程配置
git remote -v

此时应看到 gitee 和 origin (GitHub) 并存。

Step 4: 推送至 Gitee

git push -u gitee main

4. 日常工作流

配置完成后，你可以根据需求选择性推送：

• 仅推送到 GitHub: git push origin
• 仅推送到 Gitee: git push gitee

【进阶】一键同步推送

如果你希望执行一次命令同时推送到两个平台，可以给 origin 增加一个 Push URL：

git remote set-url --add origin git@gitee.com:YourName/RuoYi-Vue.git

效果：执行 git push origin 时，Git 会依次向 GitHub 和 Gitee 发送数据。

5. 避坑指南

要点	说明
-u 参数	仅在第一次推送分支时使用，用于建立 upstream 追踪关系，后续直接 git push 即可
SSH vs HTTPS	建议统一使用 SSH 协议（git@...），配置好公钥后可免密操作，效率更高
分支冲突	确保两端分支名一致（建议统一为 main），避免因 master 和 main 不同名导致的推送混乱

总结

git remote set-url 用于修改，git remote add 用于新增。合理利用多远程配置，是个人项目备份与容灾的最佳实践。