如何通过pygit2识别Git提交中的文件重命名操作？

问题的核心在于：pygit2依赖的libgit2库默认没有启用重命名检测，直接调用Repository.diff会把重命名的文件拆成“删除旧文件+新增新文件”处理，而非识别为重命名操作。

要解决这个问题，只需在生成diff时显式传入启用重命名检测的选项：

1. 启用基础重命名检测

import pygit2

# 初始化仓库
repo = pygit2.Repository("/path/to/your/repo")
# 获取目标提交对
commit_parent = repo.revparse_single("HEAD^")
commit_child = repo.revparse_single("HEAD")

# 创建启用重命名检测的Diff选项
diff_opts = pygit2.DiffOptions(flags=pygit2.DiffOption.RENAME_DETECT)
# 生成带重命名识别的diff
diff = repo.diff(commit_parent, commit_child, options=diff_opts)

2. 精准控制重命名检测（可选）
   如果需要确保只有内容完全一致的文件才被识别为重命名，可以调整相似度阈值（默认匹配度为50%）：

diff_opts = pygit2.DiffOptions(
    flags=pygit2.DiffOption.RENAME_DETECT,
    rename_threshold=100  # 仅当文件内容100%一致时判定为重命名
)
diff = repo.diff(commit_parent, commit_child, options=diff_opts)

调整后，diff结果会和git show输出一致，重命名的文件会被标记为RENAMED，而非显示为全量新增。

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