查看 Git 某个文件的历史修改记录，最推荐直接使用 git log 命令后接文件路径。该操作适用于本地仓库中已追踪的文件，属于只读查询，不会修改仓库状态，但需确保命令在仓库根目录或正确相对路径下执行。
先说结论：使用 git log 配合文件路径是查看单文件历史的标准方法，若需查看内容差异可加 -p 参数，若需查看每行代码责任人则用 git blame。
- 适合：查询已追踪文件的提交历史、作者和时间。
- 先看：确认文件路径相对于仓库根目录是否正确，避免找不到记录。
- 建议：文件发生过重命名时，添加
`--follow`参数以追踪完整历史。
命令速用版
以下命令需在 Git 仓库根目录或文件所在子目录下执行，路径指文件相对于仓库根目录的路径。
# 查看文件提交历史列表
git log -- 文件路径
# 查看历史修改的具体内容差异
git log -p -- 文件路径
# 查看文件每一行的最后修改者和提交哈希
git blame 文件路径为什么会这样
Git 基于快照记录版本变化，日志命令通过遍历提交历史筛选涉及该路径的快照。
执行 git log 时，Git 会检索提交树中所有影响指定文件路径的提交记录。默认情况下，如果文件被重命名或移动，历史可能会中断，因为 Git 默认基于路径匹配而非内容追踪。使用 `--follow` 参数可以指示 Git 在历史回溯中跟踪文件的重命名操作。
分步处理
按以下步骤操作可获取完整的文件修改详情：
- 确认文件路径：在仓库根目录运行
git status，确认文件处于 tracked 状态且路径无误。 - 执行基础查询：运行
git log -- 路径/文件名，注意使用--分隔选项和路径，防止路径名与分支名冲突。 - 增加细节参数：若需查看代码变动，追加
-p参数；若需统计行数变化，可追加`--stat`参数。 - 处理重命名历史：若发现历史记录不全，追加
`--follow`参数重新执行命令。
怎么验证是否生效
命令执行后，终端应输出包含 commit hash、作者、日期和提交信息的列表。
- 检查输出内容：确认列表中包含预期的早期提交记录，且提交信息与文件修改时间吻合。
- 验证差异内容：若使用了
-p参数，检查输出中是否包含以diff `--git`开头的代码差异块。 - 确认路径匹配：若输出为空，检查文件是否已被删除或未纳入版本控制，或尝试加上
`--follow`再次验证。
常见坑
- 路径分隔符问题：在 Windows 命令行中有时需使用反斜杠，但在 Git Bash 中建议使用正斜杠，且必须加
--分隔符避免歧义。 - 文件重命名丢失历史：默认
git log不跟踪重命名，必须显式添加`--follow`参数才能看到改名前的记录。 - 未追踪文件：对于从未
git add的新文件，无法查看历史，需先提交至少一次。
常见问题
怎么看到每次修改的具体内容？
在 git log 命令中加入 -p 参数即可显示差异。
文件改名后历史记录断了怎么办？
使用 git log `--follow` 参数可以追踪重命名前的历史。
怎么查看每一行代码最后是谁修改的？
使用 git blame 命令可以显示文件每一行的最后修改者和提交哈希。
参考来源
- Git Documentation, git-log man page, https://git-scm.com/docs/git-log
- Git Documentation, git-blame man page, https://git-scm.com/docs/git-blame