basforge

Ищем по названиям, тексту и разборам «Если не работает».

    EN

    ~/.gitconfig по блокам: что задать один раз

    Глобальные настройки git: кто мы, как называть первую ветку, что делать pull, когда ветки разошлись, как показывать конфликты и что делать с переводами строк на Windows. Всё работает с git 2.37 и новее — в Ubuntu 24.04 стоит 2.43.

    Где лежат настройки

    Уровень Файл Команда
    система /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. Перекрываем его в своём файле (последний блок).

    Файл по блокам

    ~/.gitconfig
    [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 = default

    rerere запоминает, как разрешили конфликт, и при том же конфликте в следующий раз — при повторном 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