Git 仓库同时推送到 Gitee 与 GitHub 配置指南

本指南记录了如何将本地 Git 仓库配置为通过单次 git push 命令,同时将代码推送至 Gitee 和 GitHub 两个平台,并包含常见报错(如多 URL 冲突、SSH 权限拒绝)的排查与解决方案。


目录

  • [一、 前置准备](#一、 前置准备)
  • [二、 配置双推送 (SSH 方式)](#二、 配置双推送 (SSH 方式))
  • [三、 踩坑与排查方案](#三、 踩坑与排查方案)
  • [四、 日常使用与验证](#四、 日常使用与验证)

一、 前置准备

在进行配置前,请确保满足以下条件:

  1. Gitee 仓库 :已创建对应的项目仓库(例:xxx/advanced-py)。
  2. GitHub 仓库 :必须提前在 GitHub 上创建一个同名的空白仓库 (不要勾选初始化 README 或 .gitignore,保持完全为空)。
  3. SSH 密钥 :本机已生成 SSH Key(通常在 ~/.ssh/id_rsa.pub 或 ~/.ssh/id_ed25519.pub)。生成命令:ssh-keygen -t ed25519 -C "用户名称"

二、 配置双推送 (SSH 方式)

步骤 1:清理历史冲突配置

如果之前多次修改过 pushurl,建议先清空已有的推送地址,防止出现 multiple values 错误:

bash 复制代码
git config --unset-all remote.origin.pushurl

步骤 2:添加多推送地址

依次执行以下命令,为 origin 绑定 Gitee 和 GitHub 的 SSH 推送地址:

bash 复制代码
# 1. 添加 Gitee 的 SSH 推送地址
git remote set-url --add --push origin git@gitee.com:xxx/advanced-py.git

# 2. 追加 GitHub 的 SSH 推送地址
git remote set-url --add --push origin git@github.com:xxx/advanced-py.git

# 3. 将默认拉取 (fetch) 地址也同步修改为 SSH 格式
git remote set-url origin git@gitee.com:xxx/advanced-py.git

步骤 3:验证远程配置

运行以下命令检查配置是否正确:

bash 复制代码
git remote -v

正确输出示例:


三、 踩坑与排查方案

1. 报错:warning: remote.origin.pushurl has multiple values

  • 原因 :之前曾多次添加过 pushurl,导致配置列表中存在重复或冲突的项。

  • 解决:先清空配置,再重新添加:

    bash 复制代码
    git config --unset-all remote.origin.pushurl

2. 报错:git@gitee.com: Permission denied (publickey)

  • 原因:GitHub 推送成功,但 Gitee 拒绝连接。说明本地 SSH 公钥未配置到 Gitee 账号中。

  • 解决:

    1. 查看并复制本地公钥:

      bash 复制代码
      cat ~/.ssh/id_ed25519.pub || cat ~/.ssh/id_rsa.pub
    2. 打开 Gitee 设置 -> SSH 公钥,添加复制的公钥。

PS:Github同理

  1. 测试 SSH 连通性:

    bash 复制代码
    ssh -T git@gitee.com

    返回 Hi xxx! You've successfully authenticated... 即成功。


四、 日常使用与验证

配置完成后,以后只需执行一次标准的推送命令:

bash 复制代码
git push origin master

预期输出日志:

当看到控制台分别打印了 github.com 与 gitee.com 的更新结果,即表示两端同步成功!

相关推荐
冬奇Lab8 小时前
一天一个开源项目(第263篇):江山时序 —— 纯静态的中国历史交互地图,从三家分晋拖到今天,还能让 AI 查地名
开源
wflynn9 小时前
GitHub 日榜趋势速报 | 2026-11-18
开源·github
Hvitur10 小时前
Git - 多分支合并
git·github
Pniubi11 小时前
SoduWork开源贡献日记——开源贡献入门教程
开源
考虑考虑13 小时前
git刷新远程分支列表
git·后端·gitlab
Yeautumn13 小时前
给 Antigravity 搓了个「主 Carbon + 副 Neon」混合编排插件:让顶配模型当包工头,快手模型并发干活
开源
laoyeye83114 小时前
手写 vLLM 分页 KV Cache(三):引用计数、写时复制(CoW)与前缀缓存
人工智能·github
阿里云云原生16 小时前
云原生开源项目周报(2026 / 11.09 — 11.16)
云原生·开源
一条Go17 小时前
边缘 Agent:为什么是它连出来,而不是平台连进去
后端·架构·github
一条Go17 小时前
开源新生代雷达 · 第 15 期
github