Какую задачу решает
Конфиг сервера правили вчера, сегодня что-то сломалось. Что именно меняли? Кто? Как вернуть вчерашнее,
не потеряв сегодняшнее полезное? Без истории остаются копии 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
Как устроено: три места и путь правки
правка в редакторе
- Рабочий каталог
git statusФайлы, как они лежат на диске. Git видит, что они отличаются от последнего коммита, но ничего с ними не делает. - Индекс
git addЧерновик следующего коммита. Сюда кладём то, что войдёт в коммит, — можно не все файлы и даже не все строки (git add -p). - Репозиторий
git commitКаталог.git: снимок из индекса становится коммитом с автором, датой и сообщением. Это локально — ни сеть, ни GitHub не нужны. - Удалённый репозиторий
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.
Конфиги серверов
/opt как репозиторий: правим на компьютере, на сервере — git pull («Конфиги серверов в git»).
Тексты и сайты
Markdown, MDX, документация: этот сайт — репозиторий, каждый материал — файл с историей правок.
Работа с ИИ-агентом
Коммит перед запуском агента — точка, куда вернуться, если правки не понравились («Чистый git status перед агентом»).
Свои настройки
~/.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»).
С чего начать
- Git: что это и как он хранит историю
- Git с нуля: первый репозиторий и push на GitHub по SSHСтавим git, создаём репозиторий, первый коммит и push на GitHub по SSH-ключу.
- ~/.gitconfig по блокам: что задать один разНастройки, которые стоит задать один раз: ветка
main,pullбез сюрпризов, читаемые конфликты. - Git на каждый день: состояние, коммит, ветки, синхронизацияКоманды на каждый день: статус, история, коммит, ветки, синхронизация.
- Ветки в git: слияние, rebase и конфликты по шагамСлияние, rebase и конфликты: что выбрать и как разобрать конфликт по шагам.
- Отменить в git: что случилось — какая командаЧто случилось — какая команда: от правки в файле до удалённой ветки.
- Найти, где сломалось: log, blame и bisect
log,blameиbisect: какой коммит сломал и зачем его делали. - Git и SSH-ключи: deploy key, два аккаунта, подпись коммитовDeploy key, два аккаунта GitHub на одном компьютере, подпись коммитов SSH-ключом.
- Конфиги серверов в 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-ключи».