Чтение diff и истории

git diff без аргументов сравнивает рабочее дерево с областью индекса — изменения, которые ты ещё НЕ проиндексировал. Это самый частый diff и тот, который новички читают неверно. Он не показывает всё, что ты изменил с последнего коммита; он показывает лишь то, что всё ещё не проиндексировано:

git diff

Как только ты сделаешь git add, изменение исчезает из обычного git diff (теперь оно проиндексировано), и чтобы его увидеть, нужен другой вариант. Эта неожиданность — «я правил файл, почему diff пустой?» — почти всегда означает, что ты уже его проиндексировал.

Три варианта diff сравнивают три разные пары снимков. Выбирай по тому, что хочешь увидеть:

git diff            # рабочее дерево против индекса → непроиндексированные изменения
git diff --staged   # индекс против HEAD            → что запишет коммит (также --cached)
git diff HEAD       # рабочее дерево против HEAD     → все изменения с последнего коммита (индекс + рабочее)

HEAD — это последний коммит на твоей текущей ветке. git diff --staged стоит запускать прямо перед коммитом — он показывает ровно то, что коммит будет содержать, не больше. git diff HEAD — это общая картина: всё, что отличается от последнего коммита, независимо от индексирования.

Унифицированный diff читается как набор кусков (hunks), у каждого свой заголовок и три вида строк. Вот один кусок:

@@ -12,6 +12,7 @@ function login(user) {
   const token = sign(user);
-  return token;
+  log.debug("issued token");
+  return token;
 }

Заголовок @@ -12,6 +12,7 @@ — это карта: -12,6 значит «старый файл, начиная со строки 12, протяжённостью 6 строк»; +12,7 значит «новый файл, начиная со строки 12, протяжённостью 7 строк». После него: ведущий пробел — это неизменный контекст, - — строка удалена, + — строка добавлена. Изменённая строка показывается как - (старая) сразу за которой + (новая). Читаешь сверху вниз — и точно восстанавливаешь правку.

git log выводит историю; флаги превращают стену текста в читаемую карту. Сырой лог многословен, поэтому сеньоры почти всегда его формируют:

git log                            # полные записи: хеш, автор, дата, сообщение
git log --oneline                  # одна компактная строка на коммит
git log --oneline --graph --all --decorate   # ASCII-граф веток по всем веткам

--oneline сворачивает каждый коммит до короткого хеша плюс тема; --graph рисует структуру веток/слияний; --all включает все ветки, не только текущую; --decorate показывает, какие имена веток и тегов куда указывают. Эта комбинация — самый полезный способ увидеть «какая форма у истории этого репозитория?».

git show исследует один коммит целиком — его метаданные плюс его diff. Когда log подсказал, какой коммит тебе важен, show говорит, что он сделал:

git show <commit>         # сообщение этого коммита и его полный diff
git log -p                # полный diff каждого коммита, новейшие первыми
git log --stat            # сводка по коммиту: затронутые файлы, счёт +/- строк

git show abc1234 печатает автора, дату, сообщение и точные куски, которые этот коммит внёс, — быстрейший способ ответить «что этот коммит на самом деле изменил?».