本文介绍如何使用 gitpython 库以原生、可维护的方式获取当前分支（含未提交变更）相对于 `master` 分支的所有新增或修改文件路径，替代依赖 shell 命令的 `repo.git.diff()` 调用。
在 GitPython 中，repo.head.commit.diff('master') 仅比较两个已提交快照（即当前 HEAD 提交与 master 分支最新提交），因此会遗漏工作区（unstaged）、暂存区（staged）中尚未提交的变更——这正是用户遇到的核心问题：命令行 git diff --name-only master 默认包含工作区与暂存区的差异，而 commit.diff() 不包含。
要真正复现 git diff --name-only master 的行为，需分三步获取完整变更集合：
- 暂存区 vs master（staged changes）：repo.index.diff('master')
- 工作区 vs 暂存区（unstaged changes）：repo.index.diff(None)
- 合并去重：统一提取 a_path（对新增/修改文件，a_path 即目标路径；删除时 b_path 有效，但本例暂不处理）
✅ 推荐的 Pythonic 实现如下：
import git
repo = git.Repo("path/to/your/repo")
# 获取所有变更路径（去重）
changed_files = set()
# 1. 已暂存的变更（staged）：暂存区 vs master
for diff in repo.index.diff('master'):
if diff.a_path:
changed_files.add(diff.a_path)
if diff.b_path and diff.change_type == 'D': # 删除文件也计入（可选）
changed_files.add(diff.b_path)
# 2. 未暂存的变更（unstaged）：工作区 vs 暂存区
for diff in repo.index.diff(None):
if diff.a_path:
changed_files.add(diff.a_path)
# 转为排序列表，便于阅读与后续处理
result = sorted(changed_files)
print("\n".join(result))⚠️ 注意事项：
立即学习“Python免费学习笔记（深入）”；
- repo.index.diff('master') 等价于 git diff --cached master，覆盖所有已 git add 的变更；
- repo.index.diff(None) 等价于 git diff（无参数），即工作区与暂存区对比；
- 若需严格匹配 git diff --name-only master（默认含 unstaged + staged），上述两步合并即为等效；
- diff.a_path 在新增（A）、修改（M）、重命名（R）等类型中均有效；删除（D）时 a_path 为 None，应检查 b_path；
- 避免使用 repo.head.commit.diff('master') 替代，它仅反映单次提交差异，无法覆盖多提交历史或未提交状态。
总结：GitPython 的 Index.diff() 是实现“类 CLI diff 行为”的正确抽象层。相比调用 repo.git.diff(...) 字符串命令，它更健壮、可调试、跨平台且易于集成到异常处理与日志体系中——这才是真正的 Pythonic 方式。
