使用 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免费学习笔记（深入）”；
