如何将GitCode仓库的提交同步到 GitHub

GitCode 的「仓库镜像」功能可以直接满足"在 GitCode 提交后自动同步到 GitHub"的需求。可以把它理解成一个"自动搬运工"，在 GitCode 这边的任何更新，都会被自动推送到 GitHub 上。这样可以解决github访问不稳定的问题，也可以解决一些只针对github代码的自动部署。

📝 事前准备

一个 GitHub 个人访问令牌 (Personal Access Token, classic) ：这是你在 GitCode 上有权限操作你 GitHub 仓库的"钥匙"。
1. 登录 GitHub，在右上角头像 → Settings。
2. 滚动到页面底部左侧，点击 Developer settings → Personal access tokens → Tokens (classic) → Generate new token (classic)。
3. 为令牌命名，方便日后识别。
4. 在 Expiration（过期时间） 处，可以选一个合适的日期，或设为"No expiration"。如果你的目标是长期自动同步，建议选择一个较长的时间，并记得在过期前更新。
5. 关键一步 ：在权限（Scopes）区域，勾选 repo 和 admin:repo_hook 这两项。
6. 最后点击页面底部的 Generate token。生成的令牌只会显示一次，请务必立即复制并保存好。

⚙️ 详细配置步骤

准备好令牌后，就可以在 GitCode 上开始配置了。

访问仓库镜像设置

进入 GitCode 上你想要同步的项目主页，点击顶部的 「项目设置」 ，接着在左侧菜单栏中找到 「仓库镜像」。
添加 Push 镜像

在"仓库镜像"页面，确保选中 「Push」 标签页，然后点击 「添加镜像」。
填写同步信息

在弹出的窗口中，配置以下信息：
- 目标项目地址 ：填写你的 GitHub 仓库地址。例如：https://github.com/用户名/仓库名.git。
- 账号：填写你的 GitHub 用户名。
- 个人令牌：粘贴你刚刚在 GitHub 生成并复制好的个人访问令牌。
完成添加

确认信息无误后，点击 「确认」。之后，只要你在 GitCode 仓库有新的提交（Push），系统就会自动触发同步，将更新推送到你的 GitHub 仓库。

🚀 后续使用

完成配置后，就可以回到本地，将本地仓库的远程地址改为 GitCode 的地址。

同步生效时间：每次在 GitCode 上提交代码，同步操作会自动触发，通常几秒内即可完成。
注意推送超时：根据 GitCode 官方文档，推送代码文件的超时时间是 30 分钟，如果仓库包含 LFS 大文件，超时时间为 150 分钟。
其他平台同步：同理，你还可以添加第二个 Push 镜像，将 GitHub 地址替换为 Gitee 仓库地址，实现一次提交，多平台同步。
其他同步方式选择（了解更多）
- Pull 镜像（反向同步） ：在"仓库镜像"页面选择 「Pull」，可将 GitHub/Gitee 仓库同步到 GitCode。如果你主要工作在 GitHub，但希望代码快速同步到 GitCode，可以使用此方式。
- 双向镜像：如果在 GitCode 对同一个 GitHub 仓库同时配置了 Push 和 Pull 两种镜像，就会形成双向自动同步。

⚠️ 常见问题与规避

令牌错误 ：如果配置后同步失败，请检查 GitHub 个人访问令牌是否有效（未过期），且创建时准确勾选了 repo 和 admin:repo_hook 权限。
账号格式：极少数情况下，如果 GitHub 用户名以数字开头，系统可能无法识别。此时可以在账号一栏填写 GitCode 账号用户名来尝试解决。
Token admin:repo_hook 权限问题 ：部分用户在配置镜像时可能在 GitHub Token 设置中找不到 admin:repo_hook 选项或勾选后保存失败。这通常是 GitHub 账号权限或 Token 类型导致。如果无法解决，建议优先使用更高权限的 Token（例如勾选所有 repo 相关权限）并检查 Token 是否过期。
双向镜像时的冲突风险：如果配置了"双向镜像"，务必避免两个平台同时提交，两次提交间最好保持一个大于 30 分钟的安全间隔，以免代码覆盖丢失。