我的 Git 配置
[branch]
sort = -committerdate
[tag]
sort = version:refname
[diff]
algorithm = histogram
colorMoved = plain
mnemonicPrefix = true
renames = true
[push]
default = simple
autoSetupRemote = true
followTags = true
[init]
defaultBranch = main
[pull]
rebase = true
[core]
editor = vim
[user]
name = headwindz
email = zhengjianhua.michael@gmail.com
[commit]
verbose = true
[merge]
conflictstyle = zdiff3
分支设置
[branch]
sort = -committerdate
sort = -committerdate:列出分支时(例如运行 git branch),按最近提交日期排序。减号表示降序,最近有提交的分支会排在最上面,方便找到活跃分支。
标签设置
[tag]
sort = version:refname
sort = version:refname:按版本号排序标签。例如,v1.2.0 会排在 v1.10.0 前面,后面才是 v2.0.0,而不是按字母顺序把 v1.10.0 排到 v1.2.0 前面。
差异比较设置
[diff]
algorithm = histogram
colorMoved = plain
mnemonicPrefix = true
renames = true
algorithm = histogram:使用 histogram 算法生成差异。它对齐文本的方式可能与默认的 Myers 算法不同。可以先用自己的改动比较两种输出,再选更适合的一种。
colorMoved = plain:用不同的颜色标出差异中被移动的行。代码只是换了位置时,Git 会加上视觉提示,方便审查重构。
mnemonicPrefix = true:在差异中使用含义更明确的前缀。例如,使用 i/(索引)、w/(工作树)、c/(提交)或 o/(对象)代替 a/ 和 b/,便于判断文件来自哪里。
renames = true:检测文件重命名,并在差异中显示为重命名,便于追踪文件历史。
推送设置
[push]
default = simple
autoSetupRemote = true
followTags = true
default = simple:运行未指定分支的 git push 时,将当前分支推送到上游分支,并要求两者同名。这是现代 Git 默认采用的保守选项。
autoSetupRemote = true:首次推送新的本地分支时自动设置上游分支。直接运行 git push 即可,省去手动执行 git push -u origin branch-name。
followTags = true:推送远端缺少的附注标签,前提是这些标签指向的提交可从本次推送的引用到达。轻量标签不包含在内。参见 Git push 文档。
初始化设置
[init]
defaultBranch = main
defaultBranch = main:新建仓库时,默认分支名设为 main,符合当前常用的 Git 分支命名惯例。
拉取设置
[pull]
rebase = true
rebase = true:默认使用 git pull --rebase。把本地提交逐个重放到抓取的提交之上,可以保持线性历史并避免不必要的合并提交。效果相当于先运行 git fetch,再运行 git rebase。
编辑器设置
[core]
editor = vim
editor = vim:将 vim 设为 Git 默认编辑器,用于编写提交信息、交互式变基和处理合并冲突等操作。也可以换成 nano、code 或自己习惯的编辑器。
作者信息
[user]
name = headwindz
email = zhengjianhua.michael@gmail.com
name:设置提交作者信息中显示的姓名。
email:设置提交作者信息中显示的邮箱。若希望 GitHub 或 GitLab 将提交关联到你的账号,请使用与账号关联的邮箱。
提交设置
[commit]
verbose = true
verbose = true:在提交信息编辑器中显示改动的差异,方便在编写提交信息时直接检查改动,无需切换窗口。
合并设置
[merge]
conflictstyle = zdiff3
conflictstyle = zdiff3:使用 zdiff3 冲突格式,展示原始共同祖先代码以及发生冲突的两侧内容。相比默认的 merge 格式,它给出了更多上下文,有助于理解冲突的来源。