git log --format 直接定制输出结构,用占位符如 %h、%an、%s 自由排序;需注意 %d 自带空格、%cn 与 %an 区别,避免格式错乱或信息错误。

git log 怎么用 --format 自定义字段顺序
直接改输出结构,核心是 --format 参数,不是靠别名或外部工具拼接。它支持固定占位符,比如 %h(短哈希)、%an(作者名)、%s(标题),组合顺序完全由你定。
常见错误是把 %d(ref 名称)放在最前面却没加空格,导致分支标签紧贴哈希,看起来像一串乱码;或者误用 %cn(提交者名)代替 %an(作者名),在 amend 或 cherry-pick 场景下显示错人。
-
git log --format="%h %an %s" -n 5:最简定制,5 条记录,字段间用空格分隔 -
git log --format="%h [%d] %s ":注意%d自带空格,但左右括号要手动加,否则格式混乱 - 如果想对齐列宽,
% 表示左对齐、占 20 字符,超长截断;不加对齐控制时,不同用户名长度会导致整体错位
git log --graph 配合 --format 显示分支拓扑时的坑
--graph 本身不改变字段内容,但会插入 ASCII 线条字符,一旦和 --format 混用,换行和缩进极易错乱——尤其当终端宽度不足或含中文路径时,树形图会“塌”成一行。
真实使用场景:查 feature 分支合并点、看 rebase 后的线性历史是否干净。这时候必须加 --no-abbrev-commit 避免哈希被截短,否则图形节点对应不上。
- 正确写法:
git log --graph --format="%h %d %s" --all --simplify-by-decoration - 别漏
--simplify-by-decoration,否则所有提交都画出来,图太密看不出主干 - Windows Git Bash 下若显示方块而非竖线/斜线,是终端编码或字体问题,不是命令错;换
mintty或 VS Code 内置终端通常能解决
怎么让 git log 默认走自定义格式(全局配置)
不用每次敲长长参数,用 git config 绑定一个别名即可。但要注意作用域:设成 --global 影响所有仓库,而 --local 只在当前项目生效——协作项目里乱设全局格式,可能让同事的脚本解析失败。
性能上几乎无影响,但若在 --format 里用了 %b(完整正文),log 加载会明显变慢,尤其大仓库;日常只用 %s 就够了。
- 设全局别名:
git config --global alias.lg "log --graph --format='%h %an %s' --all" - 之后直接运行
git lg,比原生命令快半秒以上(省去参数解析开销) - 别用
log --pretty=...,它和--format功能重复且优先级更低,容易覆盖失效
中文提交信息在 git log 中显示为乱码怎么办
不是 Git 本身的问题,是终端、系统 locale 和 Git 内部编码三者没对齐。Git 存储提交信息用 UTF-8,但 Windows CMD 默认是 GBK,Linux 终端若 LANG=C 也会丢弃非 ASCII 字符。
最容易被忽略的是编辑器保存编码:VS Code 默认 UTF-8 没问题,但某些老版 Sublime 或 Notepad++ 若存成 ANSI,commit 后就永久乱码,git log 再怎么配也救不回来。
- Linux/macOS:确认
locale输出含UTF-8,不是C或POSIX - Windows:Git Bash 中运行
export LC_ALL=en_US.UTF-8(加到~/.bashrc持久化) - 已有乱码提交?没法修复,只能重新 commit —— 用
git commit --amend -m "新消息"替换最后一条,旧乱码留在 reflog 里,不影响 push 后的历史


















