Git子模块预期哈希存储位置查询及哈希对比程序开发需求

Git子模块的预期提交哈希（也就是git submodule update --init --recursive命令会检出的目标哈希）存储在主仓库的提交历史和暂存区中：

• 主仓库会把每个子模块当作特殊的"文件"跟踪，这个"文件"的内容就是子模块应处于的提交哈希值。你可以用git ls-tree HEAD <子模块路径>命令直接查看，比如git ls-tree HEAD my-submodule，输出里的blob条目对应的哈希就是预期值。
• 注意：.gitmodules文件只存子模块的远程地址、路径等配置信息，不记录具体的预期哈希。

要输出预期哈希与当前哈希不匹配的子模块信息，可借助Git命令的输出解析实现，步骤如下：

1. 执行git submodule status --recursive命令，递归列出所有子模块状态，输出格式示例：

   +abc1234 my-submodule (main-123-gabc1234)
   

   各部分含义：
   • 开头的+表示子模块当前HEAD与主仓库记录的预期哈希不匹配；
   • abc1234是主仓库记录的预期哈希；
   • my-submodule是子模块路径；
   • 括号内的内容包含子模块当前所在分支名（示例中为main）。
2. 解析输出并补充信息：
   • 过滤开头为+的行（仅处理哈希不匹配的子模块）；
   • 提取路径、预期哈希、分支名；
   • 进入子模块目录执行git rev-parse HEAD，获取当前实际哈希。

import subprocess
import os

def get_mismatched_submodules():
    # 获取所有子模块状态
    result = subprocess.run(
        ["git", "submodule", "status", "--recursive"],
        capture_output=True,
        text=True,
        check=True
    )
    lines = result.stdout.strip().split('\n')
    mismatched = []
    
    for line in lines:
        if not line:
            continue
        parts = line.split(maxsplit=3)
        if len(parts) < 4:
            continue
        status_char, expected_hash, path, branch_info = parts
        if status_char != '+':
            continue
        
        # 获取子模块当前哈希
        os.chdir(path)
        current_hash = subprocess.run(
            ["git", "rev-parse", "HEAD"],
            capture_output=True,
            text=True,
            check=True
        ).stdout.strip()
        os.chdir('..')
        
        # 提取分支名
        branch_name = branch_info.strip('()').split('-')[0]
        
        mismatched.append({
            'path': path,
            'branch': branch_name,
            'expected_hash': expected_hash,
            'current_hash': current_hash
        })
    
    return mismatched

if __name__ == "__main__":
    mismatched = get_mismatched_submodules()
    if not mismatched:
        print("所有子模块哈希与预期一致")
    else:
        print("哈希不匹配的子模块：")
        for item in mismatched:
            print(f"路径: {item['path']}")
            print(f"分支: {item['branch']}")
            print(f"预期哈希: {item['expected_hash']}")
            print(f"当前哈希: {item['current_hash']}\n")

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