Provision
—— XP

Три места файла, diff и log

теория~6 минут+150 XP

Зачем в Git два шага — git add и git commit, — если в любом редакторе хватает одной кнопки «Сохранить»? Ответ — в главной идее Git, трёх местах файла. Без неё его команды выглядят случайным набором, а с ней git status, git diff и git log начинают читаться сами. Пригодится это в первую же неделю: ты поправил конфиг nginx и заодно README и хочешь закоммитить их отдельно, чтобы потом откатить одно, не трогая другое.

Файл может лежать в рабочем каталоге, где ты его правишь, в индексе, куда ты отобрал правку для будущего коммита, и в репозитории, где он сохранён в истории. Почти каждая команда Git переносит изменения через одну из этих границ или показывает разницу между двумя местами. Это похоже на сборку посылки: на столе лежат вещи, которые ты перебираешь, в коробку кладёшь только то, что решил отправить, а заклеенная коробка с накладной уже не меняется. Что-то со стола может подождать следующей посылки.

Если ты коммитишь, смотришь diff и log каждый день — этот урок можно пролистать и сразу открыть практику «две правки — два коммита». Сдалась с первого раза — значит, ничего нового здесь для тебя нет; не сдалась — вернись сюда за тем, на чём споткнулся.

Где проходят границы

Между тремя местами две двери, и у каждой своя команда.

Три области слева направо: рабочий каталог, индекс, репозиторий. Между ними стрелки add и commit. Ниже блок с командами обратного хода: restore, restore --staged и commit --amend.
add переносит правку в индекс, commit — из индекса в историю.

git add переносит правку из каталога в индекс, git commit — из индекса в историю. Обратный ход тоже есть, он внизу схемы, и ему посвящён отдельный урок. Важная деталь: git add запоминает файл таким, каким он был в момент add. Поправил после этого ещё раз — новую правку тоже придётся добавить, иначе в коммит уйдёт старая. Держать в голове, какой файл где лежит, не нужно: Git покажет это сам, стоит спросить.

Короткий статус

Полный git status многословен. Флаг -s (short) печатает по строке на файл.

ubuntu@stand:~$
git status -s
ubuntu@stand:~$
M  nginx/provision
 M README.md
?? notes.txt

Слева две колонки букв. Первая — что лежит в индексе, вторая — что изменено в каталоге, но не добавлено. M в первой колонке: правка nginx/provision уже добавлена. M во второй: README.md изменён, но не добавлен. Два вопроса ?? — файл вообще не отслеживается. Но статус не скажет, что именно поменялось внутри файла, а перед коммитом это важнее всего.

git diff: что именно изменилось

git diff показывает разницу между рабочим каталогом и индексом, то есть то, что ты ещё не добавил.

ubuntu@stand:~$
git diff
ubuntu@stand:~$
diff --git a/README.md b/README.md
--- a/README.md
+++ b/README.md
@@ -1,2 +1,2 @@
 # Конфиги стенда
-Сайт provision.
+Сайт provision и прокси к приложению.

Строки с минусом удалены, с плюсом добавлены, без знака — соседние строки для ориентира. Заголовок @@ -1,2 +1,2 @@ говорит, с какой строки начинается кусок. А то, что уже лежит в индексе и уйдёт в коммит, показывает флаг --staged.

ubuntu@stand:~$
git diff --staged
ubuntu@stand:~$
--- a/nginx/provision
+++ b/nginx/provision
@@ -12,3 +12,4 @@
     location / {
         try_files $uri $uri/ =404;
+        client_max_body_size 10m;
     }

Привычка «посмотреть git diff --staged перед коммитом» ловит большую часть ошибок: лишний файл, отладочную строку, пароль. После коммита правка переезжает в историю, и читать её нужно уже по-другому.

История: log и show

Полный git log занимает пять строк на коммит. Для обзора есть флаг --oneline: по строке на коммит, короткий хеш и сообщение.

ubuntu@stand:~$
git log --oneline
ubuntu@stand:~$
a1b2c3d (HEAD -> main) nginx: лимит загрузки 10 МБ
3f2a9c1 nginx: сайт provision со стенда

Новые коммиты сверху. Чтобы увидеть, что поменял конкретный коммит, хватает его хеша.

ubuntu@stand:~$
git show a1b2c3d
ubuntu@stand:~$
commit a1b2c3d...
Author: Anton Ivanov <anton@example.com>

    nginx: лимит загрузки 10 МБ

+        client_max_body_size 10m;

Автор, сообщение и та же разница, что ты видел в diff --staged перед коммитом. Если нужна история одного файла, допиши его имя в конец: git log --oneline nginx/provision. А на вопрос «кто написал эту строку» отвечает git blame с именем файла — она печатает рядом с каждой строкой автора и коммит. Этого хватает, чтобы на работе быстро найти, какая правка сломала сервер.

Словарь урока

рабочий каталог
Файлы на диске, которые ты правишь.
индекс
Промежуточное место, куда git add отбирает правки для будущего коммита. Другое название — staging area. ↩ к тексту
untracked
Файл, за которым Git ещё не следит. В коротком статусе отмечен ??.
diff
Разница между двумя версиями: строки с минусом удалены, с плюсом добавлены. ↩ к тексту

Что спросят на собеседовании

  • Чем git diff отличается от git diff --staged?
    git diff — разница между каталогом и индексом, то есть недобавленное. --staged — между индексом и последним коммитом, то есть то, что уйдёт в коммит.
  • Как найти, кто и когда поменял строку в конфиге?
    git blame с именем файла покажет коммит и автора каждой строки, а git show с этим хешем — всю правку и её сообщение.

Что дальше

В практике поправишь два файла, разведёшь правки по двум коммитам и посмотришь каждую через diff и show.

Проверь себя+150 XPдве попытки
1
Три места
Зачем между правкой и коммитом нужен индекс?
2
git diff
Ты сделал git add, и git diff показал пустоту. Где теперь увидеть правку?
3
git diff
Что означает строка с плюсом в начале в выводе git diff?
4
История
Как посмотреть, что именно поменял коммит a1b2c3d?
ответь на все вопросы, чтобы проверить

Нашёл ошибку или непонятное место? Наведи на абзац — слева появится «+», нажми и напиши, что не так. Замечание увидит автор курса.Нашёл ошибку или непонятное место? Нажми «+» справа от заголовка раздела и напиши, что не так. Замечание увидит автор курса.