basforge

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

    EN

    Git: что это и как он хранит историю

    Git хранит историю каталога снимками: каждый коммит — полное состояние файлов, ссылка на предыдущий и подпись «кто и зачем». Ветка — имя, указывающее на коммит, поэтому ветки ничего не стоят, а почти любое действие можно отменить. Копия на GitHub — та же история, а не отдельная программа.

    Какую задачу решает

    Конфиг сервера правили вчера, сегодня что-то сломалось. Что именно меняли? Кто? Как вернуть вчерашнее, не потеряв сегодняшнее полезное? Без истории остаются копии traefik.yml.bak, traefik.yml.old2 и память.

    Без git

    • config.yml.bak, config.yml.2026-10-17, config-рабочий.yml
    • что изменилось — сравниваем глазами
    • почему так — помнит тот, кто правил, или никто
    • копия на втором компьютере расходится с первой

    С git

    • один файл, история всех версий: git log -p config.yml
    • что изменилось с утра — git diff HEAD@{8.hours.ago}
    • почему — сообщение коммита: «traefik: таймаут 60 с — обрывались загрузки»
    • копия на GitHub и на сервере — та же история, синхронизация push и pull

    Как устроено: три места и путь правки

    правка в редакторе

    1. Рабочий каталогgit statusФайлы, как они лежат на диске. Git видит, что они отличаются от последнего коммита, но ничего с ними не делает.
    2. Индексgit addЧерновик следующего коммита. Сюда кладём то, что войдёт в коммит, — можно не все файлы и даже не все строки (git add -p).
    3. Репозиторийgit commitКаталог .git: снимок из индекса становится коммитом с автором, датой и сообщением. Это локально — ни сеть, ни GitHub не нужны.
    4. Удалённый репозиторийgit pushКопия истории на GitHub или на своём сервере. push отправляет коммиты, fetch и pull забирают чужие.

    GitHub · origin/main

    Индекс — то, чего нет в большинстве других систем, и главный источник вопросов «почему не закоммитилось». git status всегда показывает все три состояния: что в индексе (Changes to be committed), что изменено, но не добавлено (Changes not staged), и новые файлы (Untracked).

    Коммиты и ветки

    a1b2c3 ── d4e5f6 ── 9f8e7d          ← main, HEAD
                   └─── 7c6b5a ── 3e2d1c ← feature
    • Коммит — снимок всех файлов плюс ссылка на родителя. Его имя — хэш от содержимого: 9f8e7d…. Поменять коммит нельзя, можно только сделать новый: хэш изменится, и подмену видно.
    • Ветка — файл с хэшем одного коммита: .git/refs/heads/main. Новый коммит сдвигает ветку вперёд. Создать ветку — записать 41 байт, поэтому ветки заводят на каждую задачу.
    • HEAD — где мы сейчас: обычно указывает на ветку. Указывает прямо на коммит — это detached HEAD.
    • Слияние соединяет две линии новым коммитом с двумя родителями, rebase переносит коммиты одной ветки поверх другой («Ветки в git»).

    Коммиты, на которые не указывает ни одна ветка, не исчезают сразу: git reflog помнит, где был HEAD, а такие коммиты git не удаляет 30 дней (gc.reflogExpireUnreachable). Поэтому reset --hard и неудачный rebase почти всегда обратимы («Отменить в git»).

    Где применяют

    Основной случай

    Код

    Любой проект, даже на одного человека: история, ветки на эксперименты, копия на GitHub.

    Тексты и сайты

    Markdown, MDX, документация: этот сайт — репозиторий, каждый материал — файл с историей правок.

    Свои настройки

    ~/.bashrc, ~/.ssh/config, ~/.gitconfig — в репозитории dotfiles, одинаково на всех машинах. Ключи и пароли — никогда («Секрет в коммите»).

    Чем ещё решают эту задачу

    Описаны по документации на октябрь 2026, кроме git не запускались.

    Как устроено Чем отличается от git
    Git распределённая: у каждого полная история стандарт: GitHub, GitLab, все редакторы и CI
    Jujutsu (jj) работает поверх git-репозитория, совместим с GitHub нет индекса: рабочая копия — сама коммит; любое действие отменяется jj undo; конфликт можно закоммитить и разобрать позже
    Mercurial распределённая, команды проще меньше инструментов и хостингов; живёт в отдельных компаниях
    Subversion центральный сервер, история — только на нём блокировка файлов, частичное получение каталогов, большие бинарные файлы — поэтому её держат в геймдеве и у дизайнеров
    Снимки и бэкапы restic, снапшоты провайдера хранят копии, а не историю: нет «кто, зачем», нет веток и слияния. Нужны вместе с git, а не вместо
    Если… Берём
    код, конфиги, тексты, работа с кем-то или с ИИ-агентом Git
    git знаком, но мешают индекс и сложный rebase, а репозиторий — на GitHub Jujutsu поверх того же репозитория
    много больших бинарных файлов, которые правит один человек за раз Subversion или Git LFS
    нужно вернуть сервер целиком после поломки диска бэкап, а git — для конфигов

    Что получаем и чем платим

    Получаем

    • История локально. log, diff, blame и коммиты работают без сети: вся история — в .git.
    • Ветки ничего не стоят. Эксперимент — в своей ветке; не вышло — удаляем ветку, main не тронут.
    • Почти всё обратимо. Коммит, с которого ушли reset или rebase, ещё 30 дней достаётся через reflog («Отменить в git»).
    • Видно, что поменялось. git diff перед коммитом — последняя проверка, что в коммит не ушёл лишний файл.
    • Одна история везде. Компьютер, сервер и GitHub синхронизируются push и pull, без копирования папок.

    Платим

    • История помнит всё. Пароль, попавший в коммит, остаётся в истории и после удаления файла. После push считаем его утёкшим и меняем («Секрет в коммите»).
    • Команды путаются. checkout делал пять разных вещей, поэтому в 2.23 появились switch и restore; reset с тремя режимами, pull с тремя стратегиями. Настройки из «~/.gitconfig по блокам» убирают часть сюрпризов.
    • Переписанная история ломает другим. rebase и --amend после push требуют push --force, а он затирает чужие коммиты («push --force-with-lease вместо --force»).
    • Большие и бинарные файлы раздувают репозиторий. Каждая версия образа на 50 МБ — ещё 50 МБ в .git навсегда.
    • Windows меняет переводы строк. Git for Windows по умолчанию превращает LF в CRLF, и скрипт на сервере ломается на \r («Переводы строк в .gitattributes»).

    С чего начать

    1. Обзорэта страницаGit: что это и как он хранит историю
    2. МануалGit с нуля: первый репозиторий и push на GitHub по SSHСтавим git, создаём репозиторий, первый коммит и push на GitHub по SSH-ключу.
    3. Конфиг~/.gitconfig по блокам: что задать один разНастройки, которые стоит задать один раз: ветка main, pull без сюрпризов, читаемые конфликты.
    4. ШпаргалкаGit на каждый день: состояние, коммит, ветки, синхронизацияКоманды на каждый день: статус, история, коммит, ветки, синхронизация.
    5. МануалВетки в git: слияние, rebase и конфликты по шагамСлияние, rebase и конфликты: что выбрать и как разобрать конфликт по шагам.
    6. ШпаргалкаОтменить в git: что случилось — какая командаЧто случилось — какая команда: от правки в файле до удалённой ветки.
    7. МануалНайти, где сломалось: log, blame и bisectlog, blame и bisect: какой коммит сломал и зачем его делали.
    8. МануалGit и SSH-ключи: deploy key, два аккаунта, подпись коммитовDeploy key, два аккаунта GitHub на одном компьютере, подпись коммитов SSH-ключом.
    9. МануалПравки на сервереКонфиги серверов в git: /opt как репозиторийКонфиги сервера в git: /opt как репозиторий, белый список и секреты мимо истории.

    Если не работает

    fatal: not a git repository (or any of the parent directories): .git

    Причина
    Команда запущена вне репозитория: ни в текущем каталоге, ни выше нет .git.
    Делаем
    cd в каталог проекта; новый репозиторий — git init («Git с нуля»).

    Author identity unknown *** Please tell me who you are.

    Причина
    Не заданы имя и почта — без них коммит не создаётся.
    Делаем
    git config --global user.name "…" и user.email («~/.gitconfig по блокам»).

    ! [rejected] main -> main (fetch first)

    Причина
    На GitHub есть коммиты, которых нет у нас: кто-то (или мы с другого компьютера) успел запушить.
    Делаем
    git pull, разбираем конфликты, если есть, потом git push («Ветки в git»).

    fatal: Need to specify how to reconcile divergent branches.

    Причина
    Ветки разошлись: коммиты есть и у нас, и на сервере. С git 2.33 pull не выбирает способ сам.
    Делаем
    Один раз: git config --global pull.rebase true или pull.ff only («~/.gitconfig по блокам»).

    You are in 'detached HEAD' state

    Причина
    Переключились на коммит или тег, а не на ветку. Новые коммиты не попадут ни в одну ветку.
    Делаем
    Посмотрели — возвращаемся git switch main. Сделали коммиты — сохраняем веткой git switch -c fix-x.

    [email protected]: Permission denied (publickey).

    Причина
    GitHub не узнал ключ: он не добавлен в аккаунт, ssh предлагает другой ключ или git запускает другой ssh.
    Делаем
    ssh -T [email protected] — проверка без git; ключи и псевдонимы — «Git и SSH-ключи».