Просмотр изменений: status, diff и индексация по частям

[Pavel_Git]

Боль, которую мы лечим: "что я вообще наменял?"

Знакомая картина. Ты три часа правил код, бегал между файлами, что-то чинил, что-то рефакторил, заодно поправил опечатку в README и закомментировал отладочный print. Пора коммитить. И вот тут новичок делает

Код: Выделить всё

git add . && git commit -m "fixes"

- и сваливает в одну кучу пять не связанных между собой правок. История превращается в помойку, где

Код: Выделить всё

fixes

,

Код: Выделить всё

update

и

Код: Выделить всё

wip

идут стопкой, и через месяц никто (включая тебя) не поймёт, где именно сломалась логика.

Профессионал так не делает. Перед коммитом он точно знает, что изменилось, где это изменилось (в рабочем каталоге или уже в индексе) и кладёт в коммит ровно одну осмысленную порцию. Инструменты для этого - git status, git diff во всех его ипостасях и интерактивная индексация git add -p. Это не "посмотреть глазками", это снайперский контроль над тем, что попадёт в историю. Разберём механику до винтика.



Три дерева: почему diff бывает разный

Чтобы понять, посмотреть изменения git правильно, надо держать в голове три области (мы их называем "три дерева"):

• Рабочий каталог (working tree) - твои файлы на диске, как есть прямо сейчас.
• Индекс (index, он же staging area) - снимок того, что попадёт в следующий коммит. Физически это файл

  Код: Выделить всё

  .git/index

  .
• HEAD - последний коммит текущей ветки, отправная точка.

Команда

Код: Выделить всё

git add

копирует состояние из рабочего каталога в индекс. Команда

Код: Выделить всё

git commit

замораживает индекс в новый коммит. И вот ключевое: git diff показывает разницу между двумя из этих трёх деревьев, а какими именно - зависит от флагов. Отсюда и путаница у новичков: "почему git diff ничего не показывает, я же менял файл?". Потому что ты уже сделал

Код: Выделить всё

git add

, и разница между рабочим каталогом и индексом исчезла - изменение переехало в индекс.

Запомни три рабочие формы:

• Код: Выделить всё

  git diff

  - рабочий каталог против индекса. То, что ты ещё не заиндексировал.

• Код: Выделить всё

  git diff --staged

  (синоним

  Код: Выделить всё

  --cached

  ) - индекс против HEAD. То, что уже заиндексировано и уйдёт в коммит.

• Код: Выделить всё

  git diff HEAD

  - рабочий каталог против HEAD. Все изменения скопом, и заиндексированные, и нет.

git diff staged - это твоя проверка перед коммитом: "что именно я сейчас зафиксирую?". Возьми в привычку вызывать

Код: Выделить всё

git diff --staged

прямо перед каждым

Код: Выделить всё

git commit

. Это ловит случайно заиндексированный мусор лучше любого ревьюера.

git status: карта местности

Код: Выделить всё

git diff

показывает содержимое изменений, а

Код: Выделить всё

git status

- список файлов и их состояние. Посмотрим живой вывод:

Код: Выделить всё

$ git status
On branch main
Your branch is up to date with 'origin/main'.

Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
        modified:   src/auth.py

Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
        modified:   src/auth.py
        modified:   README.md

Untracked files:
  (use "git add <file>..." to include in what will be committed)
        notes.txt

Разбираем по секциям. Файл

Код: Выделить всё

src/auth.py

попал в обе секции - "Changes to be committed" и "Changes not staged". Это нормально и важно: часть правок в этом файле ты заиндексировал, а потом доправил ещё - и новые правки висят в рабочем каталоге. Индекс держит снимок, а не ссылку на файл, поэтому состояния расходятся.

Код: Выделить всё

README.md

изменён, но не заиндексирован.

Код: Выделить всё

notes.txt

- untracked, Git его раньше не видел.

Совет:

Код: Выделить всё

git status -s

даёт компактный двухколоночный вид. Левый символ - состояние индекса, правый - рабочего каталога:

Код: Выделить всё

$ git status -s
MM src/auth.py
 M README.md
?? notes.txt

Код: Выделить всё

MM

- модифицирован и в индексе, и в каталоге (тот самый расходящийся файл).

Код: Выделить всё

_M

(пробел слева) - модифицирован только в каталоге.

Код: Выделить всё

??

- untracked. Этот формат быстро читается глазами, когда файлов много.

Как читать унифицированный diff построчно

Вот сердце урока. Разберём реальный вывод

Код: Выделить всё

git diff

по косточкам:

Код: Выделить всё

$ git diff README.md
diff --git a/README.md b/README.md
index 3b18e51..d4a1c5f 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,8 @@ Installation
 Clone the repo and run:
-    pip install requirements.txt
+    pip install -r requirements.txt
+    python setup.py develop

 Run tests with pytest.

Идём сверху:

• Код: Выделить всё

  diff --git a/README.md b/README.md

  - заголовок.

  Код: Выделить всё

  a/

  - "до" (индекс),

  Код: Выделить всё

  b/

  - "после" (рабочий каталог). Это служебные префиксы, а не реальные папки.

• Код: Выделить всё

  index 3b18e51..d4a1c5f 100644

  - сокращённые хеши blob-объектов "до" и "после" плюс режим файла.

  Код: Выделить всё

  100644

  - обычный файл,

  Код: Выделить всё

  100755

  - исполняемый. Если режим сменился, тут будет видно.

• Код: Выделить всё

  --- a/README.md

  и

  Код: Выделить всё

  +++ b/README.md

  - какой файл считается старым (минус) и новым (плюс).

• Код: Выделить всё

  @@ -10,7 +10,8 @@

  - это hunk header, граница куска изменений. Читается так: со старой стороны начиная со строки 10 показано 7 строк, с новой стороны начиная со строки 10 показано 8 строк. Строк стало на одну больше - мы добавили строку. Текст после второго

  Код: Выделить всё

  @@

  (тут

  Код: Выделить всё

  Installation

  ) - это "контекстный хвост", функция или заголовок, в котором живёт правка. Git угадывает его, чтобы ты понимал, куда смотреть.
• Строки с пробелом в начале - контекст (не менялись, даны для ориентира).

  Код: Выделить всё

  -

  - удалено.

  Код: Выделить всё

  +

  - добавлено. Замена строки в diff выглядит как удаление старой плюс добавление новой - отдельной операции "изменить строку" в построчном diff нет.

По умолчанию контекста три строки сверху и снизу. Хочешь больше -

Код: Выделить всё

git diff -U10

(десять строк), меньше -

Код: Выделить всё

-U0

(только сами правки, без окружения). Когда правишь длинную строку и хочешь видеть изменение внутри строки, а не "вся строка удалена / вся добавлена", включай word-diff:

Код: Выделить всё

$ git diff --word-diff README.md
@@ -10,7 +10,7 @@ Installation
    pip install [-requirements.txt-]{+-r requirements.txt+}

Удалённое в

Код: Выделить всё

[-...-]

, добавленное в

Код: Выделить всё

{+...+}

. Для текстов, конфигов и документации это спасение: на длинной строке сразу видно, что поменялось одно слово, а не вся строка целиком. Вариант

Код: Выделить всё

--word-diff=color

красит вместо скобок, если терминал умеет в цвет.

git add -p: индексация изменений git по кускам

А вот и профи-навык, ради которого затевался урок. Индексация изменений git по частям - это

Код: Выделить всё

git add -p

(от

Код: Выделить всё

--patch

). Git режет твои правки на hunk-и и спрашивает по каждому: брать или нет. Так из одного намешанного файла рождаются чистые атомарные коммиты.

Код: Выделить всё

$ git add -p src/auth.py
@@ -42,6 +42,7 @@ def login(user, password):
     token = make_token(user)
+    log.debug("token issued for %s", user)
     return token
@@ -88,7 +89,7 @@ def logout(session):
-    session.clear()
+    session.invalidate()
     return True
(1/2) Stage this hunk [y,n,q,a,d,s,e,?]?

Git нашёл два независимых изменения и предлагает решить по каждому. Расшифровка клавиш:

• Код: Выделить всё

  y

  - да, заиндексировать этот hunk.

• Код: Выделить всё

  n

  - нет, пропустить.

• Код: Выделить всё

  q

  - выйти, ничего больше не спрашивать.

• Код: Выделить всё

  a

  - этот и все оставшиеся hunk-и в этом файле.

• Код: Выделить всё

  d

  - этот и все оставшиеся - пропустить.

• Код: Выделить всё

  s

  - split, разбить hunk на более мелкие, если между правками есть строки контекста.

• Код: Выделить всё

  e

  - edit, ручная правка hunk-а в редакторе: можно вручную решить, какие

  Код: Выделить всё

  +

  /

  Код: Выделить всё

  -

  строки войдут.

• Код: Выделить всё

  ?

  - справка прямо на месте.

Допустим, ты добавил отладочный лог и починил реальный баг с инвалидацией сессии. Логически это два разных коммита. Жмёшь

Код: Выделить всё

n

на debug-логе,

Код: Выделить всё

y

на фиксе - индексируется только баг-фикс. Коммитишь его осмысленным сообщением. Потом второй заход

Код: Выделить всё

git add -p

, и лог уходит отдельным коммитом. История чистая, каждый коммит делает одну вещь.

Про

Код: Выделить всё

s

(split) есть важная грабля - о ней ниже. Про

Код: Выделить всё

e

(edit): открывается hunk как патч, и тут правило простое. Хочешь не индексировать добавленную строку (

Код: Выделить всё

+

) - удали её строку из патча целиком. Хочешь не индексировать удаление (

Код: Выделить всё

-

) - замени минус на пробел (преврати в контекст). Не трогай счётчики в

Код: Выделить всё

@@

, Git их пересчитает сам. Ошибся - Git скажет "patch does not apply" и предложит редактировать заново или пропустить.

Старший брат -

Код: Выделить всё

git add -i

, полноценное интерактивное меню (status / update / revert / add untracked / patch / diff). На практике 95% времени хватает

Код: Выделить всё

git add -p

, а

Код: Выделить всё

-i

нужен редко. И учти:

Код: Выделить всё

-p

работает не только у

Код: Выделить всё

add

.

Код: Выделить всё

git restore -p

,

Код: Выделить всё

git stash -p

,

Код: Выделить всё

git checkout -p

,

Код: Выделить всё

git reset -p

- тот же патч-режим для откатов и стэша. Освоил один раз - применяешь везде.

git restore: снять из индекса и откатить файл

Заиндексировал лишнее? git restore - современная команда (стабильна с Git 2.51, больше не экспериментальная) с чётким разделением ролей, в отличие от перегруженного

Код: Выделить всё

git checkout

:

• Код: Выделить всё

  git restore --staged auth.py

  - снять из индекса. Возвращает файл в индексе к состоянию HEAD, рабочий каталог не трогает. Твои правки на диске целы, просто разиндексированы. Это безопасная операция.

• Код: Выделить всё

  git restore auth.py

  - откатить рабочий каталог к состоянию индекса. Внимание: правки в рабочем каталоге теряются безвозвратно, отмены через reflog тут нет. Git даже подсказывает это в

  Код: Выделить всё

  git status

  : "discard changes in working directory".

• Код: Выделить всё

  git restore --source=HEAD~2 auth.py

  - вытащить версию файла из конкретного коммита.

Именно эти подсказки печатает

Код: Выделить всё

git status

в скобках - читай их, Git буквально диктует нужную команду. Старый эквивалент -

Код: Выделить всё

git reset HEAD auth.py

(разиндексировать) и

Код: Выделить всё

git checkout -- auth.py

(откатить). Их в интернете полно, поэтому знать надо, но в новом коде пиши

Код: Выделить всё

restore

: намерение читается с первого взгляда.

diff между файлами, ветками и коммитами

Код: Выделить всё

git diff

умеет сравнивать не только дерево с индексом:

Код: Выделить всё

$ git diff src/auth.py              # один файл, каталог vs индекс
$ git diff main feature            # разница между двумя ветками
$ git diff main..feature           # то же самое (двухточечная форма)
$ git diff main...feature          # с момента, как ветки разошлись
$ git diff HEAD~3 HEAD             # последние три коммита целиком
$ git diff abc123 def456 -- src/   # между коммитами, только папка src
$ git diff --stat main feature     # сводка: сколько строк в каких файлах

Особое внимание на две точки против трёх.

Код: Выделить всё

main..feature

- прямая разница состояний двух веток.

Код: Выделить всё

main...feature

- разница от их общего предка (merge base) до feature, то есть "что нового именно в feature, не считая того, что параллельно наехало в main". Перед открытием pull request смотри именно

Код: Выделить всё

git diff main...feature

- увидишь ровно свой вклад, без шума чужих коммитов, что попали в main за это время.

А

Код: Выделить всё

--stat

даёт сводку без простыни кода - идеально оценить размах изменений перед тем, как нырять в детали:

Код: Выделить всё

$ git diff --stat HEAD~3 HEAD
 src/auth.py    | 14 ++++++++------
 README.md      |  3 ++-
 tests/test.py  | 22 ++++++++++++++++++++++
 3 files changed, 33 insertions(+), 6 deletions(-)

Типичные грабли

• "git diff пустой, а я менял файл". Ты уже сделал

  Код: Выделить всё

  git add

  . Смотри

  Код: Выделить всё

  git diff --staged

  или

  Код: Выделить всё

  git diff HEAD

  . Классика номер один.
• Путаница --staged и без него.

  Код: Выделить всё

  git diff

  - то, что не в коммите.

  Код: Выделить всё

  git diff --staged

  - то, что уйдёт в коммит. Перепутал - закоммитил не то.
• split не предлагается.

  Код: Выделить всё

  s

  доступен, только если внутри hunk-а есть неизменённые строки-контекст, разделяющие правки. Две соседние правки без контекста между ними Git разбить не сможет - тут спасёт только

  Код: Выделить всё

  e

  (ручная правка).
• git restore без --staged стёр работу.

  Код: Выделить всё

  git restore file

  (без флага) выбрасывает правки рабочего каталога без права на возврат. Хотел разиндексировать - всегда добавляй

  Код: Выделить всё

  --staged

  . Перепутал флаг - потерял час работы.
• CRLF и пробелы засоряют diff. Целые файлы краснеют из-за смены переводов строк. Лови пробельный шум флагом

  Код: Выделить всё

  git diff --check

  , а игнорируй пробелы при чтении через

  Код: Выделить всё

  git diff -w

  (но не коммить с

  Код: Выделить всё

  -w

  , это только для просмотра).
• Бинарники. Git честно пишет

  Код: Выделить всё

  Binary files a/logo.png and b/logo.png differ

  и не лезет показывать байты. Это норма, а не ошибка.

Мини-лаба: собери два чистых коммита из одной кучи

Повтори руками по шагам, это десять минут и навык в пальцах:

Код: Выделить всё

mkdir diff-lab && cd diff-lab
git init -b main
printf 'line one\nline two\nline three\n' > app.txt
git add app.txt && git commit -m "init"

# Намеренно мешаем две независимые правки в один файл
printf 'line one CHANGED\nline two\nline three\nline four added\n' > app.txt

git status                 # видим modified, файл не в индексе
git diff                   # читаем hunk: где -, где +
git diff --word-diff       # ту же правку первой строки видно по словам
git add -p app.txt         # жмём s если предложит, индексируем порциями
git diff --staged          # что уйдёт в коммит
git diff                   # что осталось в рабочем каталоге
git commit -m "rewrite line one"

git add -p app.txt         # вторую правку - отдельным коммитом
git commit -m "add line four"
git log --oneline          # два осмысленных коммита вместо одного "fixes"

# Бонус: разиндексировать и откатить
printf 'oops\n' >> app.txt
git add app.txt
git restore --staged app.txt   # сняли из индекса, правка на диске цела
git diff                       # видим oops в рабочем каталоге
git restore app.txt            # откатили - oops исчез

Контрольные вопросы

• Чем отличается

  Код: Выделить всё

  git diff

  от

  Код: Выделить всё

  git diff --staged

  и от

  Код: Выделить всё

  git diff HEAD

  ? Какие два дерева сравнивает каждая?
• В hunk header

  Код: Выделить всё

  @@ -20,5 +20,7 @@

  - что значат эти четыре числа?
• В

  Код: Выделить всё

  git add -p

  ты нажал

  Код: Выделить всё

  s

  , а Git не разбил hunk. Почему и что делать?
• Чем

  Код: Выделить всё

  git restore --staged file

  отличается от

  Код: Выделить всё

  git restore file

  и какое из них может стоить тебе работы?

Итог

Три дерева - рабочий каталог, индекс, HEAD - и три формы

Код: Выделить всё

git diff

между ними.

Код: Выделить всё

git status

даёт карту,

Код: Выделить всё

git diff

- содержимое,

Код: Выделить всё

--word-diff

спасает на длинных строках,

Код: Выделить всё

--stat

и

Код: Выделить всё

main...feature

- на ревью. А

Код: Выделить всё

git add -p

превращает кашу из правок в цепочку атомарных коммитов, где каждый делает ровно одно.

Код: Выделить всё

git restore

аккуратно снимает из индекса или откатывает файл - помни про разницу с

Код: Выделить всё

--staged

и без. Освоишь это - и твоя история перестанет быть свалкой "fixes", а станет документом, по которому можно вести расследование. В следующем уроке зафиксируем порции в настоящие коммиты и разберём анатомию хорошего сообщения.

[rjholland]

Спасибо, наконец-то дошло почему git diff показывал пусто - я же сам делал git add до этого. Теперь всегда сначала git diff --staged перед коммитом.

[WasmUser]

Граблю с restore поймал на своей шкуре месяц назад, снёс полдня работы одной командой без --staged. Жаль урока тогда не было.