直接用subprocess调用git命令同步GitLab和GitHub是轻量、可控、不依赖第三方库的可靠方案，核心三步：裸克隆→添加远程→git push --mirror，支持全分支、标签及完整历史同步，且避免API封装带来的繁琐遍历与权限管理。

直接用 subprocess 调用 git 命令同步 GitLab 和 GitHub，是轻量、可控、不依赖第三方库的可靠方案。它绕开了 API 权限配置、token 管理和网络异常重试等复杂环节，特别适合单向镜像、CI 环境或定时脚本场景。

为什么不用 python-gitlab 或 PyGithub？

这类库本质是封装 HTTP 请求，要同步完整仓库（含所有分支、tag、提交历史），你得自己遍历分支、逐个 push、处理 refspec、处理已存在远程名冲突——反而比原生命令更繁琐。而 git push --mirror 一行就搞定所有引用，subprocess 只需忠实执行它即可。

常见错误现象包括：

• 用 gl.projects.get().files.list() 拉文件再上传，丢失 commit 时间、作者、GPG 签名、merge commit 结构
• 用 git push origin main 只推单分支，漏掉 dev、release/*、refs/tags/*
• 未设置 git config --global user.name 和 user.email，导致某些 GitLab 实例拒绝接收无 author 的 push

subprocess 调用 git mirror 的最小可行脚本

核心就是三步：克隆裸仓库 → 添加目标远程 → 镜像推送。全程无需检出工作区，速度快、磁盘占用小。

实操建议：

• 始终使用 --bare 克隆，避免工作区干扰和 .git 冗余嵌套
• 远程名不要硬写 origin，改用唯一标识如 github-mirror，防止与本地开发远程冲突
• 必须捕获 subprocess.run(..., check=True) 异常，否则失败静默，同步中断无法察觉
• HTTPS URL 中的 token 要做 URL 编码（如 %40 替换 @），否则认证失败

示例代码：

import subprocess
import shlex
gitlab_url = "https://www.ufcn.cn/link/c3948f0d30ae46dbe4accafd392b3e46"
github_url = "https://www.ufcn.cn/link/27a776f3894b8fedae942a6e2ecd8082"  # 注意 %40
1. 克隆为 bare 仓库
subprocess.run(shlex.split(f"git clone --bare {gitlab_url} mirror.git"), check=True)

                                                        

                                                                
                                                                

                                                                        Python 3.14.3
                                                                        
微软官方的 Python 扩展，是 VS Code 安装量最高的扩展（209M+）。集成 IntelliSense（通过 Pylance）、调试（通过 Python Debugger）、代码检查、格式化、重构和单元测试等功能。支持 Jupyter Notebook、虚拟环境管理和多 Python 版本切换。
                                                                
                                                                下载 
                                                        
                                                
2. 进入目录并添加 GitHub 远程
subprocess.run(shlex.split("git -C mirror.git remote add github-mirror " + github_url), check=True)
3. 推送全部引用（含 branches + tags）
subprocess.run(shlex.split("git -C mirror.git push --mirror github-mirror"), check=True)

如何安全处理 GitHub Token 和权限

GitHub 要求对私有仓库或强制 2FA 的账户使用 Personal Access Token（PAT），且该 token 必须带 repo scope。直接拼在 URL 里虽简单，但有泄露风险：

• 进程列表（ps aux）可能暴露 URL 中的 token
• shell 历史记录或日志可能留存明文

更稳妥的做法：

• 用 git credential 配置 helper，把 token 存进系统凭据管理器（如 macOS Keychain、Windows Credential Manager）
• 或改用 SSH URL（git@github.com:owner/repo.git），依赖本地 ssh-agent 和 deploy key
• 若必须用 HTTPS，至少通过环境变量注入：github_url = f"https://oauth2:{os.getenv('GITHUB_TOKEN')}@github.com/..."

定时同步时容易忽略的细节

用 cron 或 GitLab CI 触发同步时，以下几点常被跳过，导致“看似运行成功，实际没更新”：

• 没清理旧裸仓库，每次克隆都新建目录，磁盘缓慢涨满
• 没加 --prune 参数，GitLab 删除了某分支，GitHub 上仍残留（git push --mirror 本身会 prune，但前提是远程引用已失效）
• 没检查 git -C mirror.git ls-remote --heads github-mirror 输出，无法确认推送是否真正落地
• 没设超时（timeout=300），大仓库 push 卡住时进程假死，后续任务堆积

真正的难点不在调用命令，而在让这个“自动同步”行为可观察、可中断、可回溯——比如每次运行后生成一个 sync.log 记录时间、HEAD commit、push 行数，比单纯写个 print("done") 有用得多。