使用 gitpython 的 `repo.head.commit.diff('master')` 可以获取当前分支最新提交与 master 的差异，但若需包含所有未提交变更（工作区/暂存区）及历史多提交差异，应改用 `repo.index.diff()` 和 `repo.head.commit.diff()` 的组合，或直接调用 `repo.git.diff()`——后者虽非纯 pythonic，却是最准确、最健壮的等效实现。
在 GitPython 中，git diff --name-only master 的语义并非仅比较“HEAD 与 master 的最后一次提交”，而是比较当前工作状态（包括已暂存和未暂存的修改）与 master 分支所指向的提交。这意味着它涵盖三类变更：
- ✅ 已暂存但未提交的修改（staged changes）
- ✅ 未暂存但已修改的工作区文件（unstaged changes）
- ✅ 当前分支相对于 master 的所有历史提交引入的变更（即 master..HEAD 范围）
而 repo.head.commit.diff('master') 仅对比两个提交对象（即 HEAD^0 与 master^0），完全忽略工作区和暂存区状态，因此无法覆盖未提交内容——这正是原问题中“不包含 prior commits or uncommitted changes”的根本原因。
✅ 推荐方案：使用 repo.git.diff()（最可靠）
尽管看似“非 Pythonic”，但这是 GitPython 官方推荐的、语义完全对齐 CLI 的方式：
import git
repo = git.Repo("/path/to/your/repo")
try:
# 等效于 git diff --name-only master
changed_files = repo.git.diff("--name-only", "master").splitlines()
# 去除空行并标准化路径（可选）
changed_files = [f.strip() for f in changed_files if f.strip()]
print("Changed files:", changed_files)
except git.GitCommandError as e:
print("Error running git diff:", e)✅ 优势：
立即学习“Python免费学习笔记（深入）”；
- 100% 复现 git diff --name-only master 行为；
- 自动包含工作区、暂存区及所有提交差异；
- 支持 --cached（仅暂存区）、--no-index 等高级选项；
- 错误处理清晰（如 master 分支不存在时抛出 GitCommandError）。
⚠️ 替代方案（有限适用场景）
若坚持纯对象式 API，可分层组合：
# 获取暂存区 vs master（即 git diff --cached master）
staged = repo.index.diff("master")
# 获取工作区 vs 暂存区（即 git diff）
unstaged = repo.index.diff(None) # None → working tree
# 获取工作区 vs master（近似，但不完全等价于 git diff master）
# 注意：此方式不处理已暂存后又被修改的文件的双重状态
all_diffs = list(staged) + list(unstaged)
# 提取唯一文件路径（去重）
all_paths = list(set(diff.a_path for diff in all_diffs if diff.a_path))⚠️ 注意：该组合方式无法完全替代 git diff master，因为 Git 的三路比较逻辑（working tree ← index ← HEAD ← master）无法通过简单拼接 index.diff() 调用精确还原，尤其在存在部分暂存（partial staging）时易遗漏或重复。
✅ 最佳实践建议
- 默认首选 repo.git.diff()：它是 GitPython 对底层 Git 命令的安全封装，语义明确、行为稳定、维护成本低；
- 避免过度追求“纯对象操作”而牺牲正确性；
- 始终添加异常处理，因分支名、仓库状态等可能动态变化；
- 若需过滤类型（如仅 M/A），可在 CLI 层加 --diff-filter=MA：
repo.git.diff("--name-only", "--diff-filter=MA", "master").splitlines()
综上，所谓“更 Pythonic”的方式，本质是更准确、更可维护、更贴近需求本质的方式——而在此场景下，repo.git.diff() 不仅合法、高效，且是 GitPython 设计者明确支持的正统路径。
