如何让repo工具生成的Manifest文件中仓库的upstream分支与提交SHA对应分支一致？

首先得明确：repo manifest -r这个命令的设计逻辑是基于本地仓库已检出的提交SHA生成manifest，但它不会自动去远程仓库查询这个SHA对应的上游分支——upstream字段默认会保留仓库最初配置的分支（比如你的main），哪怕当前SHA不在这个分支上。这就是你看到的现象：SHA正确，但upstream还是main。

要让upstream字段和提交SHA对应的分支一致，你需要手动或通过脚本关联两者，以下是具体方案：

1. 先查询提交SHA对应的远程分支 #

对于单个子仓库（比如PNG_MCU），进入仓库目录后执行以下命令，找到包含该SHA的远程分支：

# 替换成你的远程名和目标SHA
git branch -r --contains f7815add324ea221e9e8e2cc1e13e350e9d5b461 | grep REMOTE_NAME

或者更精准地过滤远程分支：

git for-each-ref --points-at=f7815add324ea221e9e8e2cc1e13e350e9d5b461 refs/remotes/REMOTE_NAME/ | awk -F'/' '{print $NF}'

这个命令会输出包含该SHA的远程分支名（如果一个SHA属于多个分支，你需要选择你期望的那个上游分支）。

2. 更新Manifest文件的两种方式 #

方式一：手动修改 #

直接编辑生成的default.xml，找到对应<project>行，把upstream字段的值替换成查询到的分支名。比如如果PNG_MCU的SHA对应feature/new-mcu分支，修改后如下：

<project name="PNG_MCU" remote="REMOTE_NAME" revision="f7815add324ea221e9e8e2cc1e13e350e9d5b461" upstream="feature/new-mcu" dest-branch="main"/>

方式二：脚本化批量修改（适合GitHub Actions场景） #

如果需要在CI/CD中自动处理，你可以写一个bash脚本，结合xmlstarlet（XML处理工具）和git命令来批量更新。示例脚本如下：

#!/bin/bash

# 确保xmlstarlet已安装（GitHub Actions中可通过apt-get install xmlstarlet）
MANIFEST_FILE="default.xml"
REMOTE_NAME="REMOTE_NAME"

# 遍历manifest中的每个project节点
for project in $(xmlstarlet sel -t -m "/manifest/project" -v "@name" -n "$MANIFEST_FILE"); do
    # 获取该project的revision SHA
    sha=$(xmlstarlet sel -t -m "/manifest/project[@name='$project']" -v "@revision" "$MANIFEST_FILE")
    # 查询该SHA对应的远程分支（取第一个匹配的分支）
    upstream_branch=$(git -C "$project" for-each-ref --points-at="$sha" refs/remotes/"$REMOTE_NAME"/ | awk -F'/' '{print $NF}' | head -n1)
    
    if [ -n "$upstream_branch" ]; then
        # 更新manifest中的upstream字段
        xmlstarlet ed -u "/manifest/project[@name='$project']/@upstream" -v "$upstream_branch" "$MANIFEST_FILE"
        echo "Updated $project upstream to $upstream_branch"
    else
        echo "No remote branch found for $project SHA $sha"
    fi
done

脚本说明： #

• 先遍历每个<project>节点，提取仓库名和对应的SHA
• 进入子仓库目录，查询该SHA对应的远程分支
• 用xmlstarlet修改default.xml中的upstream字段
• 在GitHub Actions中，需要先安装xmlstarlet（比如在Ubuntu runner中执行sudo apt-get update && sudo apt-get install -y xmlstarlet）

3. 关键注意事项 #

• 一个提交SHA可能属于多个分支（比如分支合并前的共享提交），脚本中用head -n1取第一个匹配的分支，你可以根据需求调整逻辑（比如优先匹配当前本地检出的分支对应的远程分支）
• repo sync本身只依赖revision的SHA，所以即使upstream不对也能正常同步，但如果你需要分支信息用于后续CI逻辑（比如触发分支相关的测试），就必须确保upstream正确
• 目前repo manifest没有内置参数自动更新upstream到SHA对应的分支，所以必须借助外部脚本或手动修改

内容的提问来源于stack exchange，提问作者Eyal Gerber