Где лежат настройки
| Уровень | Файл | Команда |
|---|---|---|
| система | /etc/gitconfig; у Git for Windows — в каталоге установки, etc/gitconfig |
git config --system |
| пользователь | ~/.gitconfig или ~/.config/git/config |
git config --global |
| репозиторий | .git/config |
git config в каталоге репозитория |
Читаются по порядку, и последнее значение побеждает: настройка репозитория перекрывает глобальную.
Откуда пришло значение — git config --show-origin --get <имя>.
Git for Windows уже пишет в системный файл core.autocrlf=true — это видно в git config --system --list.
Перекрываем его в своём файле (последний блок).
Файл по блокам
[user]
name = example-user
email = [email protected]Без имени и почты git не создаёт коммит. Почту берём …@users.noreply.github.com из настроек GitHub, если личную показывать не хотим («Git с нуля»).
[init]
defaultBranch = mainПервая ветка нового репозитория — main, как на GitHub. Без строки git 2.x называет её master и показывает подсказку.
по умолчанию master
[pull]
rebase = true
[rebase]
autoStash = trueКогда наша ветка и origin разошлись, pull переносит наши коммиты поверх чужих, а не делает коммит слияния «Merge branch 'main' of github.com:…». История остаётся прямой. Без настройки git с 2.33 отказывается: fatal: Need to specify how to reconcile divergent branches. autoStash — незакоммиченные правки на время rebase убираются и возвращаются сами.
по умолчанию:rebase не задано — ошибка при расхожденииautoStash false
[push]
autoSetupRemote = true
[fetch]
prune = trueПервый git push новой ветки сам создаёт её на origin и связывает — без --set-upstream origin имя (git 2.37+). prune — при fetch убирать origin/… ветки, которые удалили на GitHub, иначе список растёт годами.
по умолчанию:autoSetupRemote falseprune false
[merge]
conflictStyle = zdiff3Конфликт показывает три версии: нашу, их и общего предка между ||||||| и =======. По предку видно, кто что поменял: было port: 80, у нас стало 9090, у них 8080. Без него видны только две версии, и непонятно, чья правка новее («Ветки в git»). zdiff3 — с git 2.35.
по умолчанию merge — две версии
[rerere]
enabled = true
[diff]
algorithm = histogram
colorMoved = defaultrerere запоминает, как разрешили конфликт, и при том же конфликте в следующий раз — при повторном rebase — разрешает его сам. histogram — алгоритм сравнения, который реже путает перенесённые блоки; colorMoved красит перенесённые строки отдельным цветом.
по умолчанию:rerere.enabled falsediff.algorithm myers
[core]
editor = code --waitРедактор для сообщений коммитов и rebase. --wait обязателен: без него VS Code сразу возвращает управление, и git видит пустое сообщение. На сервере — nano или vim.
по умолчанию vi или $EDITOR
autocrlf = falseПереводы строк не трогаем: что в файле, то и в репозитории. Правила для конкретных файлов задаёт .gitattributes в самом репозитории — он едет вместе с ним на все компьютеры («Переводы строк в .gitattributes»). Строка перекрывает core.autocrlf=true, который Git for Windows пишет в системный конфиг.
по умолчанию Git for Windows — true, Linux и macOS — false
[branch]
sort = -committerdate
[tag]
sort = version:refname
[column]
ui = autoПорядок списков: ветки — свежие сверху, теги — по номеру версии (v1.10 после v1.9), списки — в колонки.
по умолчанию:branch.sort по имениtag.sort по алфавиту
[alias]
lg = log --oneline --graph --decorate --all -20
st = status -sb
last = show --stat HEADКороткие команды. git lg — граф последних 20 коммитов со всеми ветками; git st — статус в две колонки с веткой; git last — что в последнем коммите.
[includeIf "gitdir:~/work/"]
path = ~/.gitconfig-workДругая почта для рабочих репозиториев: всё, что лежит в ~/work/, берёт настройки ещё и из ~/.gitconfig-work. Слеш в конце обязателен — иначе совпадёт только сам каталог.
[gpg]
format = ssh
[commit]
gpgSign = trueПодпись коммитов SSH-ключом — тем же, что для входа. GitHub показывает у таких коммитов «Verified». Настройка и ключ для подписи — «Git и SSH-ключи».
по умолчанию без подписи
Если не работает
Настройка в ~/.gitconfig не действует в одном репозитории
- Причина
- Её перекрывает
.git/configрепозитория — он читается позже и побеждает. - Делаем
git config --show-origin --get pull.rebaseпокажет, из какого файла пришло значение.
На Windows git config --global пишет не туда, где лежит открытый файл
- Причина
HOMEу Git for Windows — не всегдаC:\Users\<имя>; у переносного git свой.- Делаем
git config --global --list --show-origin | head -1— путь к файлу, который правит git.
includeIf не подхватывает рабочие настройки
- Причина
- Путь в
gitdir:без слеша на конце совпадает только с самим каталогом, а не с репозиториями внутри; на Windows — разный регистр букв. - Делаем
- Пишем
gitdir:~/work/со слешем; на Windows —gitdir/i:для сравнения без регистра.
Как проверить
Что действует и откуда:
git config --global --list --show-origin | head -5
# file:/home/me/.gitconfig user.name=example-user
# file:/home/me/.gitconfig [email protected]
# file:/home/me/.gitconfig init.defaultbranch=main
# file:/home/me/.gitconfig pull.rebase=true
# file:/home/me/.gitconfig rebase.autostash=true
git config --show-origin --get core.autocrlf
# file:/home/me/.gitconfig false
Конфликт теперь показывает общего предка — в выводе есть строка |||||||:
name: site
<<<<<<< HEAD
port: 9090
||||||| 217e8ca
port: 80
=======
port: 8080
>>>>>>> feature
workers: 2