Gitee 迁移 GitHub 开源及双平台自动同步方案

三、自动同步方案：仅提交一端，双平台实时同步

以下三种方案覆盖个人开发、团队协作场景，均实现一次提交，自动同步，按需选择即可。

方案 A：本地 Git 多远程推送（极简配置，个人首选）

原理：本地仓库同时绑定 Gitee 与 GitHub，一次推送同步双平台，无需云端工具，零依赖。

后续使用（全程仅需常规 Git 命令）

# 常规提交
git add .
git commit -m "提交说明"
# 一次推送，同步 Gitee+GitHub
git push origin 分支名

验证配置是否生效

git remote -v # 输出中 origin 会同时显示 gitee 和 github 两个推送地址

为默认远程 origin 添加 GitHub 推送地址

git remote set-url --add origin [email protected]:用户名/仓库名.git

方案 B：GitHub Actions 自动同步（以 Gitee 为核心仓库）

适合固定向 Gitee 提交、GitHub 自动更新的场景，依托 GitHub 原生工作流实现云端自动化。

1. Gitee 生成私人令牌：进入 Gitee「设置」→「安全设置」→「私人令牌」，勾选 repo 权限，生成并复制令牌。
2. GitHub 添加密钥：进入 GitHub 仓库「Settings」→「Secrets and variables」→「Actions」→「New repository secret」，名称填写 GITEE_TOKEN，值粘贴 Gitee 令牌。
3. 提交配置文件，后续向 Gitee 推送代码，GitHub 会自动同步。

新建同步工作流：在 GitHub 仓库创建文件 .github/workflows/sync-to-gitee.yml，复制以下配置：

name: Sync Gitee to GitHub
on:
  push:
    branches: [ main, master, '*' ]
workflow_dispatch:
jobs:
  sync:
    runs-on: ubuntu-latest
    steps:
      - name: Sync Repository
        uses: wearerequired/git-mirror-action@v1
        with:
          source-repo: [email protected]:用户名/仓库名.git
          destination-repo: [email protected]:用户名/仓库名.git

方案 C：Gitee 原生仓库镜像（平台级同步，无需配置）

Gitee 自带镜像功能，无需本地/云端配置，平台级自动同步，稳定性最高。

1. 进入 Gitee 仓库「管理」→「仓库镜像管理」→「添加镜像」
2. 镜像方向选择「Push（同步到外部仓库）」
3. 填入 GitHub 仓库地址，绑定 GitHub 令牌
4. 启用镜像，后续 Gitee 提交自动同步至 GitHub

四、核心速查清单：一键复制，直接使用

1. GitHub Actions 配置速查
   直接复制上述 sync-to-gitee.yml 完整内容，修改用户名与仓库名即可使用。

迁移与多远程配置速查

# 克隆 Gitee 仓库
git clone [email protected]:用户名/仓库名.git
cd 仓库名
# 添加 GitHub 远程
git remote add github [email protected]:用户名/仓库名.git
# 全量推送
git push github --all && git push github --tags
# 配置双远程推送
git remote set-url --add origin [email protected]:用户名/仓库名.git
# 常规同步提交
git add . && git commit -m "更新内容" && git push origin

Git 基础配置速查

# Git 全局配置
git config --global user.name "你的用户名"
git config --global user.email "你的邮箱"
# 生成 SSH 密钥
ssh-keygen -t ed25519 -C "你的邮箱"
cat ~/.ssh/id_ed25519.pub

五、常见问题与避坑指南

1. 推送权限失败：检查 SSH 密钥是否添加双平台、令牌权限是否完整，优先使用 SSH 地址而非 HTTPS。
2. 分支同步不全：必须使用 --all 与 --tags 参数，确保全量分支与标签同步。
3. 代码冲突：同步前先拉取远程最新代码，保持本地与源仓库一致。
4. 自动化同步失败：检查 GitHub 密钥配置、YAML 文件缩进、Gitee 令牌是否过期。
5. 开源合规：迁移后添加 LICENSE、完善 README，避免敏感信息泄露。

六、方案选型建议

• 个人独立开发：选择方案 A，本地一次配置，无依赖、操作最简单。
• 团队协作：选择方案 B 或方案 C，统一提交入口，避免成员本地配置不一致。
• 长期维护：定期检查双平台同步状态，保持分支、版本、文档一致。

七、总结

从 Gitee 迁移至 GitHub 开源，核心是一次迁移、永久自动同步，无需重复提交与手动维护。本文提供的三种方案覆盖不同使用场景，配合可直接复制的命令与配置清单，可快速实现仅提交一端，双平台自动同步的目标，彻底解决多平台代码托管的繁琐问题。