介绍从 Gitee 迁移项目至 GitHub 的完整流程，包括保留提交历史的本地克隆推送方法。提供三种自动化同步方案：本地 Git 多远程推送、GitHub Actions 工作流同步以及 Gitee 原生仓库镜像功能。涵盖 SSH 密钥配置、权限检查、常见问题排查及速查命令清单，帮助开发者实现单端提交双平台自动同步，降低维护成本。
多数国内开发者习惯使用 Gitee 托管代码，兼顾访问速度与协作便捷性。当项目需要面向全球开源、接入开源社区时，GitHub 是更适配的平台。但手动在两个平台重复提交、同步分支，不仅增加开发成本，还容易出现提交历史不一致、分支冲突、版本遗漏等问题。
本文针对从 Gitee 迁移项目至 GitHub 开源、仅提交一端即可实现双平台自动同步的核心需求，提供完整迁移流程、三种自动化同步方案，以及可直接复制的命令与配置清单，一次配置永久生效，彻底告别手动同步。
开始迁移与同步前，先完成基础配置，避免权限报错、推送失败等问题，所有命令可直接复制执行。
配置 SSH 密钥（双平台通用，无密码推送）
# 生成 SSH 密钥（一路回车，无需设置密码）
ssh-keygen -t ed25519 -C "你的注册邮箱"
# 查看公钥内容，复制后添加到 Gitee 和 GitHub 的 SSH 密钥设置中
cat ~/.ssh/id_ed25519.pub
检查并配置本地 Git 环境
# 查看 Git 版本，确认已安装 Git
git --version
# 配置全局用户名与邮箱（与 Gitee/GitHub 账号保持一致）
git config --global user.name "你的用户名"
git config --global user.email "你的注册邮箱"
迁移核心是全量同步代码、分支、提交历史，推荐本地克隆推送方式，稳定性最高。
方法 1：本地克隆 + 双远程推送（推荐）
git clone [email protected]:用户名/仓库名.git
cd 仓库名
# 添加 GitHub 远程源，命名为 github
git remote add github [email protected]:用户名/仓库名.git
# 查看远程地址，确认 gitee 与 github 均已绑定
git remote -v
# 推送所有分支
git push github --all
# 推送所有标签
git push github --tags
推送完成后，刷新 GitHub 仓库页面，即可看到与 Gitee 完全一致的代码与提交历史。
方法 2：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 原生工作流实现云端自动化。
repo 权限，生成并复制令牌。GITEE_TOKEN，值粘贴 Gitee 令牌。新建同步工作流：在 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 自带镜像功能，无需本地/云端配置，平台级自动同步，稳定性最高。
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
--all 与 --tags 参数，确保全量分支与标签同步。从 Gitee 迁移至 GitHub 开源，核心是一次迁移、永久自动同步，无需重复提交与手动维护。本文提供的三种方案覆盖不同使用场景，配合可直接复制的命令与配置清单，可快速实现仅提交一端，双平台自动同步的目标，彻底解决多平台代码托管的繁琐问题。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online