深入理解 git log 提交历史查看与过滤基于 first-contributions 项目的实战指南【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址: https://gitcode.com/gh_mirrors/fi/first-contributions本文基于 first-contributions 仓库的法语附加材料查看提交日志系统讲解git log命令的默认行为、按路径与按提交标识过滤、排除规则^与输出条数限制-n四类核心用法。读完本篇你可以在参与开源贡献如向 Contributors.md 添加自己的名字的过程中准确定位谁在什么时候改了什么并能用提交范围表达式精确圈定要审查的历史区间。1. 核心命令与默认行为查看某个分支或某个文件的提交历史使用的命令是git log [options] [path]两个关键事实来自法语原文档的明确说明[path]是可选的位置参数传入后日志只列出修改过该路径的提交命令输出默认按逆时间顺序reverse chronological order排列即最新的提交排在最前面。法语原文档给出的命令骨架第 5 行与默认逆序的描述第 7 行即对应上面两条参见 docs/additional-material/translations/French/check-commit-log.fr.md。同主题还有英文原版 check-commit-log.md 与中文译本 check-commit-log.zh-cn.md可对照阅读。1.1 一份典型输出长什么样英文原版文档 check-commit-log.md 中保留了一份来自本仓库真实运行结果2024-06 的提交的样例输出非常适合用来拆解git log每一行的含义$ git log commit e3fabb30ab536bd5876461d8a749301a321e714f (HEAD - check-commit-log-ko, upstream/main, origin/main, origin/HEAD, main) Author: Dan Yunheum Seol yunheum.seolmail.mcgill.ca Date: Tue Jun 4 01:07:25 2024 -0400 Add dan-seol to Contributors list (#84962) commit 4af4ec8a56e057ce8768af77eda528453974d0bc Author: Edgar Humberto Tijerina Tamez 168693312EdgarHTTusers.noreply.github.com Date: Mon Jun 3 23:06:05 2024 -0600 Add Edgar Tijerina to Contributors list (#84961)逐行解读输出元素含义commit 40 位哈希该提交的唯一标识commit id / object name是后文按提交 id 过滤时的坐标(HEAD - check-commit-log-ko, upstream/main, origin/main, ...)指向该提交的引用refs列表本地分支、上游远端分支、origin/HEAD等都标注在此Author:作者姓名与邮箱Date:提交时间含时区如-0400、-0600缩进的正文提交说明subject body本仓库的惯例格式是Add 名字 to Contributors list (#PR 编号)注意第二、三条记录中作者邮箱带有users.noreply.github.com后缀——这是 GitHub 的匿名回邮地址机制说明这些提交是通过 Pull Request 流程由机器人代合并产生的与本仓库新手通过 PR 贡献的定位一致。2. 按路径与按范围过滤提交历史2.1 只查某个文件的历史传入路径参数即可只列出动过该文件的提交git log [path]例如查看仓库根目录 README.md 的变更历史git log README.md在当前仓库快照上实际运行该命令输出为commit 8f0c0846fa39ecc6f9a27c439af53cf595202ad2 Author: Hamza Haji 119335393HMZ-Husers.noreply.github.com Date: Thu Sep 17 01:38:01 2026 0300 Add Hamza Haji to Contributors list (#125032) Co-authored-by: Claude Opus 4.6 noreplyanthropic.com这里只有一条记录并非命令失效而是当前克隆的本地历史较浅git rev-list --count HEAD结果为 1。这恰好直观说明了git log的第一个隐含前提默认只追踪从当前 HEAD 可达的历史。若本地历史不完整可先确认克隆深度或使用下文的范围选项。2.2 跨所有引用查询git log --all 文件名法语原文档给出的第 3 种用法是查看某个文件在所有引用下的完整提交日志git log --all nom_du_fichier不带--all时git log只看**当前分支HEAD**可达的提交加上--all后等价于展开本地所有分支与标签等引用再取并集因此能看到当前分支上看不到、但存在于其他分支中的文件修改历史。对新手贡献者来说这个选项在以下场景特别有用你把自己的改动提交到了本地功能分支想确认该文件在主分支之外还有哪些分支动过它git log --all 文件名可以一次性给出全局视图。2.3 只看分支范围的对照作为--all的一个收敛版本git log --branches只展开本地分支不含远端跟踪引用与标签。在当前仓库上实测$ git log --branches -n 3 --oneline 8f0c0846f Add Hamza Haji to Contributors list (#125032)由于当前快照的本地分支只有main所以与git log输出一致而在多分支协作如同时保留main与某个 PR 分支时二者差异就会显现。从输出结构看--all/--branches的本质只是改变可达性起点集合后面的过滤规则路径、条数、提交 id均照常叠加。3. 按提交 id 圈定区间可达性与^排除这是法语原文档第 10–13 行着墨最多的部分也是git log最强大、也最容易理解错的能力。3.1 从多个提交 id 出发git log foo bargit log foo bar含义列出从foo和bar两个提交标识均可达并集的提交。foo、bar是占位符实际使用时可写完整 40 位哈希也可写 git 能解析的唯一前缀缩写。一个典型的贡献工作流假设foo是上游仓库的最新提交bar是你本地功能分支的提交那么git log foo bar就列出了我这条分支相对上游多出来 上游本身的全部历史常用于 PR 前的自检。3.2 排除一个起点git log foo bar ^baz在提交 id 前加^caret表示从可达集合中移除该起点及其可达历史git log foo bar ^baz含义列出从foo、bar可达但从baz可达的提交全部剔除。^语法的核心价值在于差集运算。最常见的组合是git log upstream/main..HEAD # 等价于 git log HEAD ^upstream/main即我的本地分支相对于上游主干新增了哪些提交。这与法语原文档在 id 前加^以排除该 id 可达的提交第 12 行是同一机制只是用引用名代替了 id 缩写。理解了^就理解了 git 一切区间表达A..B即B ^A的基础。3.3 与git rev-list的关系git log本质上是git rev-list只输出提交列表加上格式化渲染。同一套起点/排除规则对两者完全一致因此当只需要提交 id 列表而不需要作者、时间、正文时可以用git rev-list foo bar ^baz来核对git log的过滤结果是否符合预期。4. 控制输出条数git log -n 5法语原文档第 16–17 行的第 4 种用法是限制日志显示的提交数量git log -n 5只输出最近的 5 条提交。对大历史仓库这是防止终端被刷屏的最低成本手段也适合只想扫一眼最近几次改动的快速审查。可以推断-n参数与前述所有过滤选项路径、--all、提交 id、^均可自由组合例如只看某文件最近 10 次修改git log --all -n 10 nom_du_fichier另外--oneline选项会把每个提交压缩成一行短哈希 标题与本仓库英文原版文档第 9 节示例中使用的紧凑视图风格一致适合配合-n使用git log --oneline -n 20--oneline为补充建议用法不在法语原文档列举范围内。5. 在 first-contributions 贡献流程中的实战位置first-contributions 是一个面向新手的项目仓库描述Help beginners to contribute to open source projects核心贡献动作是在 Contributors.md 中登记自己的名字并发起 PR。git log在该流程中至少承担三个角色提交前自查git log -n 5确认自己最近的提交信息与顺序是否符合预期定位自己的 PR 提交git log --all --grepContributors list或按路径git log --all Contributors.md可以确认登记类提交的历史脉络与上游对比用^排除语法如git log HEAD ^origin/main确认本地分支相对远端ahead了哪些提交——当前仓库git status -sb显示main...origin/main [ahead 1, behind 34411]正是这类本地历史与远端存在偏移的典型状态此时单看git log默认输出不足以反映全貌需配合--all或远端引用一起分析。需要说明的前提与限制上述结论基于当前仓库快照实测本地保留 1 条提交、远端跟踪引用指向origin/main如果你克隆的副本历史完整git log默认输出会包含数千条记录建议始终搭配-n或路径过滤使用。本仓库的附加材料docs/additional-material/围绕同一 git 工作流主题还提供了大量姊妹文档建议配合阅读法语版同目录文档amending-a-commit.fr.md修正提交理解提交 id 变了会怎样与本文的提交 id 过滤互为前提英文版工作流场景系列check-commit-log.md、resolving-merge-conflicts.md、resetting-a-commit.md、stashing-a-file.md各语言译文总览Translations.md。6. 要点速查表需求命令出处查看当前分支历史默认逆序git log法语原文档只看某文件的修改历史git log [path]法语原文档该文件在所有引用下的完整历史git log --all nom_du_fichier法语原文档从多个提交 id 可达的历史git log foo bar法语原文档排除某提交 id 可达的历史git log foo bar ^baz法语原文档限制条数最近 5 条git log -n 5法语原文档只看 id 列表git rev-list foo bar ^baz由git log机制推导建议核对用法更完整的参数与选项如--author、--grep、--graph、--pretty等请参阅 Git 官方git-log手册man git-log。【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址: https://gitcode.com/gh_mirrors/fi/first-contributions创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考