如何从含多远程的本地Git仓库拆分出单个远程的独立仓库

核心思路 #

利用Git的**对象引用（alternates）**机制，让新创建的小仓库直接复用大仓库的pack文件，无需复制重复数据，同时将大仓库中对应远程的分支映射到新仓库的本地和远程分支，完全避免重新fetch的带宽和时间消耗。

具体操作步骤 #

假设你的大仓库路径为/path/to/big-repo，以下为单个pypi-mirror-N.git远程拆分的完整步骤，所有操作可批量自动化执行：

1. 创建空的裸仓库 #

# 创建并进入新仓库目录
mkdir pypi-mirror-N && cd pypi-mirror-N
# 初始化无工作树的裸仓库（与原大仓库结构一致）
git init --bare

2. 配置共享对象库（避免重复存储数据） #

在新仓库的.git/objects/info目录下创建alternates文件，写入大仓库的objects路径：

# Windows环境请用正斜杠或转义反斜杠，比如 "C:/path/to/big-repo/.git/objects"
echo "/path/to/big-repo/.git/objects" > .git/objects/info/alternates

此操作让新仓库直接读取大仓库的pack文件，不会占用额外磁盘空间。

3. 从大仓库导入分支引用 #

映射远程分支

# 将大仓库的pypi-mirror-N.git/code映射到新仓库的origin/code
git fetch /path/to/big-repo refs/remotes/pypi-mirror-N.git/code:refs/remotes/origin/code
# 将大仓库的pypi-mirror-N.git/main映射到新仓库的origin/main
git fetch /path/to/big-repo refs/remotes/pypi-mirror-N.git/main:refs/remotes/origin/main

设置本地分支与默认远程

# 创建本地main分支，跟踪origin/main
git branch main refs/remotes/origin/main
# 添加原远程地址（替换为对应N的真实远程URL）
git remote add origin <原pypi-mirror-N的远程URL>
# 设置仓库默认HEAD指向main分支
git symbolic-ref HEAD refs/heads/main

4. 验证仓库结构 #

执行以下命令确认分支结构符合预期：

git branch -a
# 预期输出：
# * main
#   remotes/origin/code
#   remotes/origin/main

批量处理脚本（PowerShell示例） #

针对230个仓库，可编写批量脚本减少重复操作：

$bigRepoPath = "C:\path\to\big-repo\.git"
$baseRemoteUrl = "https://example.com/pypi-mirror-" # 替换为真实远程前缀

for ($N=1; $N -le 230; $N++) {
    $repoName = "pypi-mirror-$N"
    New-Item -ItemType Directory -Path $repoName | Out-Null
    Set-Location $repoName
    git init --bare
    echo "$bigRepoPath\objects" > .git\objects\info\alternates
    git fetch $bigRepoPath refs/remotes/pypi-mirror-$N.git/code:refs/remotes/origin/code
    git fetch $bigRepoPath refs/remotes/pypi-mirror-$N.git/main:refs/remotes/origin/main
    git branch main refs/remotes/origin/main
    git remote add origin "$baseRemoteUrl$N.git"
    git symbolic-ref HEAD refs/heads/main
    Set-Location ..
}

注意事项 #

• 不要删除原大仓库，否则所有拆分后的小仓库会丢失对象数据；若后续需要脱离大仓库，可在小仓库执行git repack -a，将所需对象复制到本地（会占用额外磁盘空间）。
• 原大仓库有更新时，小仓库可直接通过git fetch origin拉取远程更新，也可从大仓库同步（执行git fetch /path/to/big-repo）。
• Windows环境下注意路径转义，避免含空格或特殊字符的路径引发错误。

内容的提问来源于stack exchange，提问作者Paul Moore