Что такое git diff?

Что такое git diff

git diff — это фундаментальная команда в системе контроля версий Git, предназначенная для отображения различий (разницы) между различными состояниями файлов в репозитории. По сути, она отвечает на вопрос: «Что изменилось?». Это основной инструмент для анализа изменений на всех уровнях работы с Git: от незакоммиченных правок в рабочей директории до сравнения веток и конкретных коммитов.

Основное назначение и использование

Команда git diff используется для сравнения:

1. Рабочей директории и индекса (области staged): git diff (без аргументов). Показывает изменения в файлах, которые еще не были добавлены в индекс командой git add.
2. Индекса и последнего коммита: git diff --staged (или git diff --cached). Показывает изменения, которые уже проиндексированы и будут включены в следующий коммит.
3. Двух произвольных коммитов: git diff <commit1> <commit2>. Сравнивает состояния репозитория на момент этих коммитов.
4. Двух веток: git diff <branch1>..<branch2> (символ .. часто опционален). Показывает разницу между кончиками веток.
5. Конкретного файла между коммитами или ветками: git diff <commit1> <commit2> -- <path/to/file>.

Формат вывода

Вывод git diff имеет стандартизированный формат (unified diff), который является ключом к его пониманию:

• Заголовок: Указывает, какие версии файлов сравниваются.
• Блоки изменений (hunks): Каждый блок начинается с строки @@ -x,y +a,b @@, где x — номер строки в исходном файле, y — количество строк, a и b — аналогично для нового файла.
• Строки кода:

    *   Строка, начинающаяся с **`-`** (минус), была удалена в новой версии.
    *   Строка, начинающаяся с **`+`** (плюс), была добавлена в новой версии.
    *   Строка, начинающаяся с пробела, осталась без изменений и приведена для контекста.

Пример вывода:

diff --git a/script.js b/script.js
index a1b2c3d..e4f5g6h 100644
--- a/script.js
+++ b/script.js
@@ -5,7 +5,10 @@ function calculateTotal(price, quantity) {
     const baseCost = price * quantity;

     // Применяем скидку
-    const discount = baseCost * 0.1;
+    let discount = baseCost * 0.1;
+    if (quantity > 10) {
+        discount = baseCost * 0.2; // Большая скидка для опта
+    }

     const total = baseCost - discount;
     return total;

В этом примере видно, что строка с объявлением const discount была изменена на let discount, и добавлен блок if для увеличения скидки при большом количестве.

Практическое применение в рабочем процессе Frontend Developer

Для фронтенд-разработчика git diff — это инструмент ежедневного использования:

• Перед коммитом: Выполнив git diff --staged, я проверяю, точно ли те изменения, которые я добавил в индекс, являются тем, что я хочу закоммитить. Это помогает избежать попадания в коммит отладочного кода (console.log) или случайных правок.
• Анализ истории: git diff HEAD~2 HEAD показывает, что именно изменилось за последние два коммита. Это незаменимо при поиске причины появления бага (регрессии).
• Сравнение веток: Перед слиянием feature-ветки в main я запускаю git diff main..feature/my-feature, чтобы увидеть итоговый набор всех изменений, которые будут смержены. Это виртуальный аналог просмотра Pull Request (Merge Request) в терминале.
• Внешние утилиты: Часто вывод git diff перенаправляется в более наглядные графические утилиты (например, git difftool) или является основой для работы инструментов в IDE (VSCode, WebStorm) и на хостингах кода (GitHub, GitLab), где diff отображается интерактивно и цветно.
• Создание патчей: Команда git diff > mypatch.patch позволяет экспортировать изменения в виде файла-патча, который затем можно применить к другой копии репозитория через git apply. Это устаревший, но иногда полезный способ передачи изменений.

Полезные опции

• git diff --stat — показывает сжатую статистику: какие файлы изменены и сколько строк добавлено/удалено в каждом.
• git diff --word-diff — подсвечивает изменения по словам, а не по строкам, что очень удобно для правок в текстовом контенте или комментариях.
• git diff HEAD — показывает разницу между рабочей директорией и последним коммитом (объединяет вывод git diff и git diff --staged).

Итог: git diff — это не просто команда, а центральный механизм Git для инспекции данных. Умение «читать» ее вывод — базовый навык разработчика, который позволяет понимать историю проекта, контролировать качество своих коммитов и эффективно сотрудничать с командой. Это мост между сырыми изменениями в файловой системе и структурированной историей коммитов в репозитории.