config

Ctime: 2025-12-31  |  Mtime: 2026-06-24  |  Author: ljf12825

配置作用域

Git的配置文件不是只有一个，而是分三层，优先级从高到低是

项目级 > 用户级 > 系统级

项目级

位于.git/config，具有最高优先级，只对当前仓库生效。用--local参数标识。通常存的是

  • 这个仓库专用的用户名和邮箱
  • 项目特定的remote地址
  • Git hooks 路径
  • 子模块配置

用户级

位于~/.gitconfig。对当前用户的所有仓库生效。用--global参数标识。通常存的是

  • 全局的用户名和邮箱
  • 个人常用的 alias
  • diff/merge 工具的偏好
  • GPG签名密钥

系统级

位于etc/gitconfig，最低优先级，对所有用户的所有仓库生效。用--system标识。一般公司或团队做统一配置时会用到，个人很少碰

用命令操作三层

读取配置时，Git自动合并三层，高优先级覆盖低优先级

# 查看生效的最终值（已经合并三层后的结果）
git config <key>

# 查看某一层的原始值
git config --local <key> # 项目级
git config --global <key> # 用户级
git config --system <key> # 系统级

# 写入某一层
git config --local user.name "Project Name" # 写入 .git/config
git config --global user.name "My Name" # 写入 ~/.gitconfig
git config --system user.name "Admin" # 写入 /etc/gitconfig

# 查看某一层的整个文件
git config --local --list
git config --global --list
git config --system --list

配置文件格式

配置文件采用INI风格，由节(section)和键值对组成

基本结构

[section]
    key = value

节名用方括号包裹，键值对缩进写在节下面，等号两边空格可选

带子节(subsection)

[branch "main"]
    remote = origin

子节名用双引号包裹，大小写敏感（节名本身大小写不敏感）。常用于remote, branch, submodule等需要具名的场景

注释

# 以`#`或`;`开头的行都是注释
[core]
    autocrlf = input # 仅在提交时转换

值的类型

  • 字符串：直接写，含空格时加引号"my value"
  • 布尔：true/false，也接受yes/no, on/off, 1/0
  • 整数：支持k, m, g后缀，如pack.packSizeLimit = 100m

多值（同一key出现多次）

[remote "origin"]
    fetch = +refs/heads/*:refs/remotes/origin/*
    fetch = +refs/pull/*:refs/remotes/origin/pr/*

同一key可以重复，git config --get-all可以读出全部值

转译字符

值里的特殊字符用反斜杠转义：\\表示反斜杠，\"表示双引号，\n表示换行，\t表示Tab

include 无条件引入

~/.gitconfig里可以用include引入额外文件

[include]
    path = ~/.gitconfig.local    # 机器特定的配置
    path = ~/.gitconfig.company  # 公司项目的通用配置

Git读到这里时，会把指定文件的内容“内联”进来，效果等同于直接写在原文件里。路径支持~和相对路径（相对于当前配置文件所在目录）

includeIf条件引入

根据条件决定是否加载某个配置文件

[includeIf "条件:值"]
    path = ~/.gitconfig_xxx

常用条件类型

gitdir：匹配仓库的.git目录路径

[includeIf "gitdir:~/work/"]
    path = ~/.gitconfig_work

[includeIf "gitdir:~/personal/"]
    path = ~/.gitconfig_personal

~/work/下的所有仓库自动用工作账号，~/personal/下用个人账号。路径末尾的/表示匹配该目录及其所有子目录

onbranch：匹配当前分支名

[includeIf "onbranch:release/**"]
    path = ~/.gitconfig_release

在release/开头的分支上，自动加载额外配置

环境变量覆盖

Git读取配置文件的路径本身可以被环境变量替换。优先级高于默认路径

环境变量作用
GIT_CONFIG_SYSTEM覆盖系统级配置文件路径
GIT_CONFIG_GLOBAL覆盖用户级配置文件路径
GIT_CONFIG_NOSYSTEM设为1时完全跳过系统级配置
GIT_CONFIG_COUNT + GIT_CONFIG_KEY_n / GIT_CONFIG_VALUE_n临时注入键值对，不修改任何文件

最后一个适合CI/CD场景临时传入配置

GIT_CONFIG_COUNT=2 \
GIT_CONFIG_KEY_0=user.name \
GIT_CONFIG_VALUE_0="CI Bot" \
GIT_CONFIG_KEY_1=user.email \
GIT_CONFIG_VALUE_1="ci@example.com" \
git commit -m "automated commit"

进程结束配置就会消失，不需要修改任何配置文件

常用配置文件字段和对应命令参数

身份配置

user.name 提交作者名

[user]
    name = ljf12825

等价命令

git config --global user.name "ljf12825"

对应提交对象里的 author, committer，只影响后续新提交，不会修改历史commit

user.email 提交作者邮箱

[user]
    email = xxx@example.com

等价命令

git config --global user.email "xxx@example.com"

editor / pager

core.editor Git需要输入长文本时调用的编辑器(commit message, rebase todo等)

[core]
    editor = vim

等价命令

git config --global core.editor "vim"

优先级低于环境变量

GIT_EDITOR > VISUAL > EDITOR > core.editor

core.pager 分页器

[core]
    pager = less -FRX

控制

  • git log
  • git diff
  • git show

等命令的输出分页行为

禁用分页

git --no-pager log

或

[core]
    pager = cat

line ending

core.autocrlf 换行符自动转换

[core]
    autocrlf = input

常见值

值行为
truecheckout转CRLF，commit转LF
input仅commit时转LF
false不转换

Linux/macOS通常用input，Windows团队通常用true

真正决定文本规范的通常还是.gitattributes

而不是autocrlf

merge / rebase

pull.rebase git pull时是否默认rebase

[pull]
    rebase = true

等价

git pull --rebase

开启后fetch + rebase，替代fetch + merge

可以避免无意义merge commit

rebase.autoStash rebase前自动stash工作区

[rebase]
    autoStash = true

适合：有未提交修改，但想先pull –rebase 的场景

alias

alias.co

[alias]
    co = checkout

等价

git co

复杂alias支持shell

[alias]
    lg = log --graph --oneline --decorate

带!会交给shell执行

[alias]
    cleanup = "!git branch --merged | grep -v main | xargs git branch -d"

signing

commit.gpgSign 提交默认开启GPG签名

[commit]
    gpgSign = true

对应

git commit -S

user.signingKey 指定签名key

[user]
    signingKey = ABCDEF123456

network

remote.origin.url 远程仓库地址

[remote "origin"]
url = git@github.com:user/repo.git

对应

git remote set-url origin ...

push.default git push的默认行为

[push]
    default = simple

现代Git默认是simple，即“当前分支推送到同名upstream”

diff

merge.tool 配置 merge 工具

[merge]
    tool = vscode

performance

core.fsmonitor 文件系统监控优化，大型仓库能显著降低git status扫描成本

feature.manyFiles Git官方提供的大仓库优化preset

[feature]
    manyFiles = true

适合：

  • monorepo
  • node_modules 巨多
  • UE/Unity 工程