Git日志格式化与美化工具
指导
Git日志格式化与美化工具
粘贴来自 git log 的原始输出--oneline, --medium，并且 --pretty=fuller并立即将其转换为干净、易于扫描的HTML表格、可直接复制的Markdown表格或结构化的JSON数组。该工具会自动检测最常见的日志格式（
如何使用
- 运行
git log），并规范化日期列，因此您可以将结果直接用于发布说明、拉取请求描述或内部仪表板。 - 将其粘贴到 在终端中使用您偏好的标志运行 ，然后复制输出。
- 离开 输入格式 在 自动检测Git日志输出
- 选择一个 ，或者选择您实际使用的格式。 (ISO、短格式、RFC 2822或相对时间) 如果您希望规范化时间戳。
- 选择您的 输出格式 ：HTML表格、Markdown表格或JSON数组。
- 使用复制按钮获取源内容，下载按钮保存文件，或查看位于源代码上方的实时HTML预览。
特征
- 自动检测格式 – 无需配置即可识别
--oneline,--medium，并且--pretty=fuller输出。 - 三种输出目标 – 一键生成带有样式的HTML表格、GitHub风格的Markdown表格或JSON数组。
- 实时HTML预览 – 在源代码上方查看渲染后的表格，以便您确切知道读者将看到的内容。
- 可配置的时间格式 – 将Git默认的日期字符串转换为ISO 8601、短日期、RFC 2822或可读的相对时间。
- 哈希、作者、日期、主题列 – 从日志块中自动检测，当字段缺失时保持输出紧凑。
- 引用和合并提交 – 保留标题中的分支和标签引用，以及
Merge:行存在时的 - 仅客户端 – 您的提交信息保留在浏览器中；没有任何内容被上传或存储。
常问问题
-
Git日志的oneline格式和medium格式有什么区别？
这
--oneline格式以每行一个提交的方式打印，格式为<short-hash> <subject>，可选地后跟括号内的引用名称。默认的--medium格式为每个提交打印一个多行块，第一行包含完整的哈希值，并带有标记的Author:且Date:标题，后跟缩进的提交信息。medium格式更详细，但保留了作者信息和时间戳；oneline格式更紧凑，适合快速浏览历史记录。 -
Git为何默认以非ISO格式打印日期？
Git继承了其默认日期格式（RFC 2822风格，例如
Tue Oct 10 13:55:36 2024 -0700），源自早期Unix邮件约定，当时提交最初以电子邮件补丁形式交换。ISO 8601更适用于机器处理，因此Git也支持--date=iso以及多种其他格式。消费日志输出的工具通常会规范化日期，以便下游系统能够可靠地排序或比较提交。 -
Git提交中的短哈希代表什么？
每个Git提交都由其内容的40字符SHA-1（或在新仓库中为SHA-256）摘要唯一标识。短哈希只是该摘要的前7（或更多）个字符。Git会自动扩展所需数量的字符以确保在特定仓库内仍具有唯一性，因此短哈希是紧凑但仍然唯一标识提交的参考。
-
什么是合并提交，它与普通提交有何不同？
普通提交只有一个父提交，表示在现有历史基础上的线性变更。合并提交有两个或更多父提交，用于将两条分歧的分支合并在一起。在
git log --medium中，合并提交通过额外的Merge:标题列出父提交哈希，从而与功能提交区分开来。 -
为什么HTML和Markdown表格对共享提交历史很有用？
原始版
git log输出是等宽文本，在大多数文档系统中无法良好渲染。将其转换为HTML或Markdown表格后，每个提交字段都有独立的列，使读者能够一次查看多个提交，还能将历史记录嵌入到发布说明、变更日志、维基或拉取请求描述中，而Markdown和HTML在这些场景中是第一类公民。
