Unity LineRenderer绘制3D圆环：从数学原理到性能优化的完整指南
2026/7/12 8:39:26
Git log --pretty=format 高级格式化：3 个自定义模板实现日志分析与导出
版本控制系统中的提交历史就像一本详实的开发日记，而git log --pretty=format则是我们定制这本日记格式的魔法笔。不同于基础教程中简单的占位符介绍，本文将深入探讨如何通过格式化字符串构建三种实用模板，满足代码审计、变更追踪和自动化流程中的不同需求。
1. CSV格式模板：结构化数据分析
当需要将提交历史导入Excel或数据库进行分析时，CSV格式是最佳选择。以下模板将关键提交信息转换为标准的逗号分隔值格式：
git log --pretty=format:'"%h","%an","%ad","%s"' --date=iso > commits.csv这个命令会生成包含以下字段的CSV文件：
- 简短提交哈希(
%h) - 作者姓名(
%an) - ISO格式的提交日期(
%ad) - 提交信息(
%s)
进阶技巧：
- 添加
--numstat参数可包含变更统计：git log --pretty=format:'"%h","%an","%ad","%s"' --date=iso --numstat > commits_stats.csv - 处理包含换行符的提交信息：
git log --pretty=format:'"%h","%an","%ad","%f"' --date=iso | tr '\n' ' ' > commits_clean.csv
字段对照表：
| 占位符 | 说明 | CSV中的用途 |
|---|---|---|
| %h | 简短提交哈希 | 唯一标识提交 |
| %an | 作者姓名 | 责任追踪 |
| %ad | 作者日期 | 时间序列分析 |
| %s | 提交信息 | 变更原因分析 |
| %f | 净化后的提交信息 | 避免CSV格式破坏 |
提示：在Excel中导入时选择"文本限定符为双引号"，可正确处理字段中的逗号
2. JSON输出模板：CI/CD系统集成
现代持续集成系统通常需要结构化数据输入，以下模板生成符合JSON标准的提交历史：
git log --pretty=format:'{%n "commit": "%H",%n "author": "%an",%n "date": "%ad",%n "message": "%s"%n},' --date=iso | sed '$ s/,$//' | awk 'BEGIN{print "["};{print $0};END{print "]"}'生成的JSON示例：
[ { "commit": "a1b2c3d4e5f6", "author": "John Doe", "date": "2023-05-15 10:30:00 +0800", "message": "修复登录验证逻辑" }, { "commit": "b2c3d4e5f6g7", "author": "Jane Smith", "date": "2023-05-14 15:45:00 +0800", "message": "添加用户管理模块" } ]增强版本：
- 包含变更文件列表：
git log --pretty=format:'{%n "commit": "%H",%n "files": [' --name-only | awk '/^$/{next} NR>1 && /^[^{]/{print " \""$0"\","} /^{/{print $0} END{print " ]"}' - 添加颜色编码的严重级别：
git log --pretty=format:'{%n "commit": "%H",%n "severity": "%C(auto)%s"' | grep -Eo '"severity": ".*?(feat|fix|chore|refactor|test).*?"'
3. 终端友好模板：带颜色的图形化输出
对于日常开发中的终端查看，这个别名配置提供了最佳可读性：
git config --global alias.lg "log --color --graph --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset' --abbrev-commit --date=relative"使用git lg命令将看到：
* 1a2b3c4 - (HEAD -> main) 更新文档 (2小时前) <张三> * 5d6e7f8 合并特性分支 (1天前) <李四> |\ | * 9g8h7i6 添加新API端点 (3天前) <王五> |/ * 0k9j8i7 初始化项目 (1周前) <赵六>自定义元素解析：
%Cred%h%Creset- 红色提交哈希%C(yellow)%d%Creset- 黄色引用名称%s- 提交信息%Cgreen(%cr)- 绿色相对日期%C(bold blue)<%an>%Creset- 加粗蓝色的作者名
扩展配置：
- 添加文件变更统计：
git config --global alias.lgstat "log --stat --graph --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset'" - 按日期范围过滤：
git lg --since="1 week ago" --until="yesterday"
4. 高级应用场景与技巧
4.1 多仓库日志聚合分析
当项目包含多个子模块时，这个脚本可以聚合所有提交历史：
#!/bin/bash REPO_ROOT=$(git rev-parse --show-toplevel) find "$REPO_ROOT" -name .git -type d | while read -r gitdir; do repo_path=$(dirname "$gitdir") echo "=== 仓库: ${repo_path##*/} ===" git -C "$repo_path" log --pretty=format:'%h | %an | %ad | %s' --date=short done | tee combined_logs.txt4.2 自动化变更报告生成
结合邮件发送的周报生成脚本：
#!/bin/bash WEEK_START=$(date -d "last monday" +%Y-%m-%d) REPORT_FILE="weekly_report_$(date +%Y%m%d).html" git log --since="$WEEK_START" --pretty=format:'<tr> <td>%h</td> <td>%an</td> <td>%ad</td> <td>%s</td> </tr>' --date=short | awk 'BEGIN{ print "<html><head><title>周开发报告</title></head><body><table border=1>" print "<tr><th>提交</th><th>作者</th><th>日期</th><th>描述</th></tr>" };{print};END{print "</table></body></html>"}' > "$REPORT_FILE" # 使用邮件客户端发送报告 mutt -s "每周代码报告 $(date +%F)" team@example.com -a "$REPORT_FILE" < /dev/null4.3 与图形工具集成
将格式化输出导入可视化工具时，这个模板特别有用：
git log --pretty=format:'%h|%p|%an|%ad|%s' --date=iso --all | \ awk -F'|' '{ printf "{\"id\":\"%s\",\"parent\":\"%s\",\"author\":\"%s\",\"date\":\"%s\",\"message\":\"%s\"}\n", $1, $2, $3, $4, $5 }' > graph_data.json配合D3.js等库可以生成交互式提交图谱。