git pull --all 为何不复存在？如何实现多Git仓库分支批量拉取？

阿华AIGC实验室

2026-6-13

问题描述

目录结构如下：

root
|
\- GitRepoA
\- GitRepoB
\- GitRepoC
...
\- GitRepoN

希望在每个Git仓库中高效执行git pull master或git pull main操作，这些仓库部分使用master分支，部分使用main分支。

曾找到相关方案提及git pull --all命令，但查阅Git文档后并未发现pull命令支持--all参数的说明，因此有两个疑问：

git pull --all功能发生了什么变化？
如何实现它原本被宣称能达成的效果？

关于`git pull --all`的说明

首先明确：Git的pull命令本身从来没有正式支持过--all参数。

之前网上流传的git pull --all，本质是利用了Git参数传递的“漏洞”：git pull是git fetch + git merge的组合命令，早期Git版本会把未识别的参数直接传递给底层的git fetch——而fetch确实有--all参数（用于拉取所有远程仓库的所有分支）。但pull的merge步骤只会处理当前本地分支对应的远程分支，并不会合并所有分支，所以所谓的git pull --all从始至终都只能完成“拉取所有远程分支”，无法自动合并所有分支。

后续Git版本（2.20+开始）对参数校验做了严格限制，现在执行git pull --all会直接抛出参数错误，这就是你找不到该参数官方说明的原因——它从来不是pull的合法参数，只是早期的非预期用法被修复了。

实现批量拉取对应主分支的方案

针对你的目录结构，推荐用脚本批量遍历仓库，自动识别远程主分支（main/master）并执行拉取：

Bash脚本（Linux/macOS）

#!/bin/bash
# 遍历当前目录下的所有Git仓库
for dir in */; do
    if [ -d "$dir/.git" ]; then
        echo "=== 处理仓库: $dir ==="
        cd "$dir" || continue
        # 获取远程默认分支名
        DEFAULT_BRANCH=$(git remote show origin | grep "HEAD branch" | awk '{print $NF}')
        # 拉取对应主分支
        git pull origin "$DEFAULT_BRANCH"
        cd ..
    fi
done

将脚本保存为batch_pull.sh，赋予执行权限chmod +x batch_pull.sh，在root目录下运行即可。

PowerShell脚本（Windows）

# 遍历当前目录下的所有Git仓库
Get-ChildItem -Directory | ForEach-Object {
    $gitDir = Join-Path $_.FullName ".git"
    if (Test-Path $gitDir) {
        Write-Host "=== 处理仓库: $($_.Name) ==="
        Set-Location $_.FullName
        # 获取远程默认分支名
        $defaultBranch = git remote show origin | Select-String "HEAD branch" | ForEach-Object { $_.Line -split ' ' | Select-Object -Last 1 }
        # 拉取对应主分支
        git pull origin $defaultBranch
        Set-Location ..
    }
}

保存为batch_pull.ps1，在root目录的PowerShell窗口运行即可。