Какая структура запроса git diff?

Структура и синтаксис команды git diff

Команда git diff — один из самых мощных инструментов Git для анализа изменений. Она позволяет увидеть разницу (diff) между различными состояниями репозитория: файлами, коммитами, ветками или даже отдельными этажами в индексе (Staging Area).

Базовая структура команды можно представить как:

git diff [<опции>] [<объект-1>] [<объект-2>]

Основные формы и объекты сравнения

git diff сравнивает два "объекта". Эти объекты могут быть:

• Коммиты (их хэши, теги или относительные ссылки, например HEAD~2)
• Ветки (например, main и feature)
• Файлы на разных этажах Git (Working Directory, Staging Index, Repository)

1. Сравнение незакоммиченных изменений в рабочей директории с последним коммитом

git diff

Самая частая форма. Показывает изменения в файлах, которые уже изменены в рабочей директории, но еще не добавлены в индекс (git add). Сравнивает текущее состояние файлов на диске (working tree) с состоянием в HEAD (последний коммит в текущей ветке).

2. Сравнение изменений в индексе (Staging Area) с последним коммитом

git diff --staged
# или, что то же самое
git diff --cached

Показывает изменения, которые уже добавлены в индекс командой git add, но еще не закоммичены. Это то, что попадет в следующий коммит после выполнения git commit. Сравнивает состояние индекса с HEAD.

3. Сравнение двух конкретных коммитов

git diff <хэш-коммита-A> <хэш-коммита-B>

Показывает все изменения файлов между двумя точками в истории. Порядок важен: изменения показываются как переход от коммита A к коммиту B.

# Пример: что изменилось между коммитами abc123 и def456
git diff abc123 def456

# Использование относительных ссылок
git diff HEAD~3 HEAD  # Сравнение текущего коммита с тем, который был три коммита назад

4. Сравнение двух веток

git diff <ветка-1> <ветка-2>

Показывает разницу между последними коммитами (HEAD) двух веток. Часто используется для проверки, что было добавлено в feature-ветку перед мержем.

# Пример: что добавили в ветку feature относительно main
git diff main feature

# Частый кейс: что изменилось в текущей ветке относительно main?
git diff main..
# или просто (сравнивает текущую ветку с main)
git diff main

5. Сравнение конкретного файла между двумя состояниями

git diff <объект-1> <объект-2> -- <путь-к-файлу>

Ограничивает вывод diff только одним файлом или набором файлов.

# Пример: как изменился файл src/app.js между коммитами
git diff abc123 def456 -- src/app.js

# Пример: как изменился файл index.html в индексе относительно HEAD
git diff --staged -- index.html

Формат вывода и ключевые опции

Вывод git diff имеет стандартный unified diff format и очень информативен.

• Строка заголовка: показывает, какие файлы сравниваются (например, diff --git a/file.txt b/file.txt). a/ и b/ — условные префиксы для первого и второго объекта сравнения.
• Блоки изменений (hunks): каждый блок начинается с строки, описывающей диапазон изменений в файле (например, @@ -10,5 +10,7 @@). Числа показывают строки в первом (-) и втором (+) объекте.
• Строки кода: изменения обозначаются символами в начале строки.

    *   `-` (красный в цветном выводе) — строка удалена из первого объекта.
    *   `+` (зеленый) — строка добавлена во второй объект.
    *   строка без символа — контекст, неизмененная код.

Полезные опции для управления выводом

# Цветной вывод (часто включен по умолчанию)
git diff --color

# Вывод в более кратком, статистическом формате
git diff --stat
# Покажет что-то вроде:
#  src/app.js | 5 +++++-----
#  README.md  | & +++++++++

# Ограничить вывод только именем измененных файлов
git diff --name-only

# Игнорировать изменения только в пробелах (отступы, концы строк)
git diff --ignore-all-space

# Показать разницу в одном файле между текущей рабочей версией и версией в индексе
git diff HEAD -- file.txt

Практическое значение и примеры использования в разработке

Понимание структуры git diff критически важно для повседневной работы:

• Проверка перед коммитом: git diff --staged — последний шаг перед git commit. "Что именно я сейчас коммичу?"
• Анализ истории: git diff abc123 def456 помогает понять, что конкретно изменилось между двумя версиями продукта, например, между релизами.
• Подготовка к мержу: git diff main feature показывает весь объем изменений feature-ветки, который будет интегрирован в main.
• Локализация изменений в большом коммите: git diff HEAD~1 -- src/components/ показывает изменения только в папке компонентов в последнем коммите.
• Выявление "белого шума": git diff --ignore-all-space помогает сосредоточиться на существенных изменениях кода, игнорируя reformatting.

Таким образом, git diff — это не просто команда, а инструмент для точного контроля над изменениями. Его гибкая структура, где можно комбинировать объекты сравнения (коммиты, ветки, этажи) и опции фильтрации (по файлам, по типу изменений), делает его незаменимым для отладки, ревью кода и анализа истории проекта.