Git分支切换时Smudge Filter如何获取新分支日志？

这个问题我之前踩过坑！确实是Smudge过滤器的执行时机搞的鬼——它在HEAD切换到目标分支之前就启动了，所以你直接调用git log拿到的肯定是旧分支的信息，完全不对。给你两个实用的解决思路，亲测有效：

思路一：用Git自带的环境变量直接拿目标分支名 #

Git在执行git checkout或git switch这类分支切换操作时，会自动设置几个关键环境变量，你可以在Python脚本里直接读取：

• GIT_NEW_HEAD_NAME：目标分支的名称（比如你要切到的dev分支）
• GIT_PREV_HEAD_NAME：切换前的原分支名称

在你的Smudge脚本里，可以先判断这个变量是否存在。如果存在，就直接基于目标分支获取提交信息，否则 fallback 到当前HEAD（比如重新检出文件的场景）：

import os
import subprocess

def get_commit_details():
    target_branch = os.environ.get('GIT_NEW_HEAD_NAME')
    git_cmd = ['git', 'log', '-1', '--format=%H|%an|%ad']
    
    if target_branch:
        git_cmd.append(target_branch)
    
    try:
        result = subprocess.run(
            git_cmd,
            capture_output=True,
            text=True,
            check=True
        )
        commit_hash, author, date = result.stdout.strip().split('|')
        return commit_hash, author, date
    except subprocess.CalledProcessError as e:
        # 处理Git命令执行失败的情况，比如分支不存在
        print(f"Git command failed: {e.stderr}", file=sys.stderr)
        return None, None, None

不过要注意，这个环境变量只在分支切换场景下存在，git clone、git reset或单独检出文件时可能不会触发，所以一定要留好fallback逻辑。

思路二：直接针对当前处理的文件Blob查提交（更靠谱） #

更通用的方法是直接获取Smudge正在处理的文件Blob对应的提交信息——不管HEAD有没有切换，这个Blob本身属于目标分支的版本，查它的提交肯定是正确的。

Git 2.11及以上版本会在Smudge过滤器运行时设置GIT_OBJECT_ID环境变量，它就是当前处理的Blob的SHA-1哈希。你可以用这个哈希直接查询对应的提交：

import os
import subprocess
import sys

def get_commit_details():
    blob_id = os.environ.get('GIT_OBJECT_ID')
    git_cmd = ['git', 'log', '-1', '--format=%H|%an|%ad']
    
    if blob_id:
        git_cmd.extend(['--object-name', blob_id])
    
    try:
        result = subprocess.run(
            git_cmd,
            capture_output=True,
            text=True,
            check=True
        )
        commit_hash, author, date = result.stdout.strip().split('|')
        return commit_hash, author, date
    except subprocess.CalledProcessError as e:
        print(f"Git command failed: {e.stderr}", file=sys.stderr)
        return None, None, None

这个方法适配所有场景：切换分支、重新检出文件、克隆仓库都能拿到正确的提交信息，推荐优先使用。

额外注意事项 #

• 确认Git版本：如果用GIT_OBJECT_ID，需要Git 2.11+，可以用git --version检查。
• 异常处理：一定要给subprocess调用加try-except，避免脚本崩溃导致Git操作失败。
• 多场景测试：记得在切换分支、重新检出文件、克隆仓库这些场景下都测试一遍，确保脚本行为符合预期。

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