Рецензирование AI-сгенерированного кода с помощью Difftastic

AI-инструменты для написания кода нередко объединяют реальное логическое изменение с масштабным переформатированием в одном коммите, и построчный git diff топит единственную строку, меняющую поведение, в море красного и зелёного. Difftastic — это структурный инструмент сравнения, который разбирает код в синтаксические деревья и сравнивает именно их, а не текст. Благодаря этому чистое переформатирование, перенос строк и правки пробелов отображаются как отсутствие изменений — остаются только правки, влияющие на поведение программы. В этой статье рассказывается, что такое difftastic, как интегрировать его в git и как выстроить конкретный рабочий процесс для рецензирования коммитов, которые генерирует агент.

Проблема: AI-диффы скрывают важную строку

Агенты и ассистенты — такие как Cursor, GitHub Copilot и Claude Code — нередко переформатируют целую функцию или разбивают длинный вызов на несколько строк в том же коммите, где меняется одно условие. Построчный diff не способен отличить одно от другого: он помечает каждую затронутую строку как изменённую. В результате вы получаете стену красного и зелёного, а единственная правка, влияющая на поведение программы во время выполнения, где-то внутри неё. Рецензирование AI-сгенерированного кода — это именно та ситуация, где соотношение сигнала к шуму критически важно: переформатирование — это машинный мусор, а изменение поведения — то, за слияние чего вы несёте ответственность.

Что такое difftastic?

Difftastic — это структурный инструмент сравнения, который сопоставляет файлы на основе их синтаксиса, а не текста. Он разбирает каждую версию с помощью tree-sitter, строит абстрактное синтаксическое дерево и сравнивает деревья. Практический результат: если вы переформатируете код так, что он теперь занимает несколько строк, difftastic покажет только то, что действительно изменилось, а перемещённый или переименованный блок будет отображён как перемещение, а не как удаление плюс добавление.

Difftastic написан на Rust, создан Уилфредом Хьюзом и распространяется с открытым исходным кодом под лицензией MIT. Он поддерживает более 30 языков программирования через парсеры tree-sitter — не «50+», как утверждают некоторые обзоры. Когда файл имеет нераспознанное расширение, инструмент корректно переключается на построчный diff с подсветкой слов, так что ничего не ломается на языках, которые он не умеет разбирать.

Установка difftastic и интеграция с git

Установите бинарный файл difft через пакетный менеджер или cargo, затем зарегистрируйте его как внешний инструмент сравнения git:

# macOS
brew install difftastic

# Rust toolchain (требуется Rust 1.85+ начиная с версии 0.69)
cargo install difftastic

Для разового использования передайте конфигурацию inline, чтобы ничего не менять постоянно:

git -c diff.external=difft diff
git -c diff.external=difft show --ext-diff

Чтобы сделать difftastic инструментом по умолчанию, добавьте следующее в ~/.gitconfig, как указано в документации:

[diff]
    external = difft

Это переключает git diff на использование difftastic; для остальных подкоманд достаточно флага --ext-diff, например git show --ext-diff и git log -p --ext-diff. Рекомендуемая конфигурация изменилась в difftastic 0.61 (октябрь 2024 года), поэтому если вы копируете старый фрагмент из блога, замените его актуальной версией из документации. Для вывода в одну колонку вместо двухколоночного режима по умолчанию используйте --display inline:

difft old.js new.js --display inline

Почему difftastic выигрывает при рецензировании AI-кода?

Структурное сравнение фокусируется на изменённых синтаксических узлах и устраняет шум от несущественных правок. Наглядный пример — случай «переформатирование плюс один аргумент». Допустим, агент берёт однострочную сигнатуру функции и, поскольку она теперь превышает ограничение длины строки, форматтер разбивает её на несколько строк — и при этом агент добавляет один аргумент:

// before
function createUser(name, email) {}

// after
function createUser(
  name,
  email,
  role,
) {}

Построчный diff выделит весь блок, поскольку каждая строка изменилась текстуально. Difftastic выделит только новый аргумент role — единственную правку, меняющую поведение. Именно такое незаметное добавление агент может провести мимо рецензента, бегло просматривающего шумный diff. Та же логика применима к выделению кода: когда агент переносит блок в новую вспомогательную функцию, difftastic отмечает новое имя функции как добавленное, вместо того чтобы показывать обёртку и тело как одно запутанное удаление плюс добавление.

Рабочий процесс рецензирования коммитов агента

Чтобы видеть только семантические изменения, внесённые агентом, укажите конкретный коммит:

git show <agent-commit> --ext-diff
# или просмотрите всю ветку
git log -p --ext-diff main..agent-branch

Обращайте внимание на три вещи: добавления и удаления, которые difftastic действительно помечает как изменения; блоки, отображаемые как перемещения или переименования, а не переписывания; и любой фрагмент, возвращающийся к обычному построчному диффу — это сигнал о том, что difftastic столкнулся с нераспознанным расширением или ошибкой разбора. По умолчанию difftastic переключается на построчный diff при любых ошибках разбора — консервативный выбор, гарантирующий, что инструмент никогда не объявит два синтаксически разных файла одинаковыми. Это важно для AI-вывода в середине рефакторинга, который может не разбираться корректно; повысьте порог терпимости командой export DFT_PARSE_ERROR_LIMIT=20, если почти валидный файл излишне переключается в режим fallback.

Для автоматизации difftastic может проверить, имеют ли два файла одинаковое AST, не отображая diff:

difft --check-only --exit-code before.js after.js

Это устанавливает код выхода 0 при отсутствии синтаксических изменений и 1 при их наличии — быстрая проверка для pre-merge хука или шага CI, отвечающего на вопрос: «агент изменил поведение или только переформатировал код?»

Ограничения и использование difftastic в паре с delta

Стоит честно признать компромиссы. Difftastic сравнительно плохо масштабируется на файлах с большим количеством изменений и может потреблять много памяти, поэтому используйте его как инструмент рецензирования конкретных коммитов, а не как полноценную замену git diff. Его отображение в две колонки обычно удобно, но иногда может запутать. Это внешний инструмент сравнения, а не git-пейджер, и он не работает во вкладке Files в GitHub PR или в большинстве панелей diff в IDE — это локальный CLI-инструмент.

Практическое решение — использовать оба инструмента. Оставьте быстрый текстовый пейджер для повседневного просмотра и переключайтесь на difftastic для сложных диффов с обширным переформатированием.

Delta и diff-so-fancy работают с текстом; ни один из них не выполняет AST-сравнение. Используйте delta как пейджер по умолчанию и обращайтесь к difftastic, когда diff утопает в форматировании.

Чистое структурное сравнение — это фильтр перед слиянием: он позволяет поймать строку, меняющую поведение, до того как вы одобрите изменения. Правки, которые всё равно проскальзывают — незаметная логическая правка, скрытая шумным AI-диффом, — это именно те, которые приходится восстанавливать уже после выпуска, и просмотр записи сессии со сломанным взаимодействием — один из наиболее прямых способов выявить такой класс регрессий. Настройте [diff] external = difft сегодня, затем просмотрите следующий коммит агента командой git show <commit> --ext-diff и читайте только то, что действительно изменилось.

Часто задаваемые вопросы

В чём разница между difftastic и delta?

Difftastic — это структурный инструмент сравнения, который разбирает код с помощью tree-sitter и сравнивает абстрактные синтаксические деревья, поэтому переформатирование и перенос строк отображаются как отсутствие изменений. Delta — это текстовый пейджер с подсветкой синтаксиса, который по-прежнему сравнивает строки. Difftastic не может работать как git-пейджер и функционирует только как внешний инструмент сравнения, тогда как delta работает как пейджер для повседневного просмотра. Используйте delta по умолчанию, а difftastic — для AI-диффов с обширным переформатированием.

Что происходит, когда difftastic встречает файл, который не может разобрать?

Difftastic переключается на построчный diff с подсветкой слов в двух случаях: когда файл имеет нераспознанное расширение и когда возникают ошибки разбора. Переключение при ошибках разбора — намеренный консервативный выбор, чтобы difftastic никогда не объявлял два синтаксически разных файла одинаковыми. Это важно для AI-вывода в середине рефакторинга, который может не разбираться корректно. Повысьте порог терпимости с помощью переменной окружения DFT_PARSE_ERROR_LIMIT, если почти валидный файл излишне переключается в режим fallback.

Может ли difftastic отображать диффы во вкладке Files в GitHub PR?

Нет. Difftastic — это локальный инструмент командной строки, работающий как внешний инструмент сравнения git, а не как слой отображения во вкладке Files в GitHub PR или в большинстве панелей diff в IDE. Вы запускаете его через команды вроде git show с флагом --ext-diff или git log -p --ext-diff. Сторонние интеграции существуют для некоторых инструментов, например magit, но поддержка вкладки PR и IDE ограничена, поэтому difftastic лучше всего рассматривать как шаг рецензирования в терминале.

Как проверить, изменил ли AI-коммит поведение кода или только переформатировал его?

Запустите difft с флагами --check-only и --exit-code на двух версиях файла. Difftastic проверяет, имеют ли файлы одинаковое абстрактное синтаксическое дерево, не отображая diff, и устанавливает код выхода 0 при отсутствии синтаксических изменений и 1 при их наличии. Это значительно быстрее полного сравнения и обеспечивает чёткую проверку для pre-merge хука или шага CI, позволяя отличить реальные изменения поведения от чистого переформатирования.