git-diff-files

Создать патч (см. раздел Создание текста патча с помощью -p).

Подавить весь вывод механизма diff. Полезно для подавления вывода таких команд, как git show, которые по умолчанию показывают патч, или для отмены действия таких параметров, как --patch, --stat, указанных ранее в командной строке в псевдониме.

Создать diff с <n> строками контекста. По умолчанию число строк контекста равно diff.context или 3, если переменная конфигурации не задана. (-U без <n> молча принимается как синоним -p из-за исторической случайности.) Подразумевает --patch.

Выводить данные в указанный файл вместо stdout.

Указать символы, используемые для обозначения новых, старых строк и строк контекста в создаваемом патче. Обычно это соответственно +, - и ' '.

Создать diff в необработанном формате. Это вариант по умолчанию.

Синоним для -p --raw.

Включить эвристику, смещающую границы фрагментов diff, чтобы патчи было удобнее читать. Это вариант по умолчанию.

Отключить эвристику отступов.

Потратить дополнительное время, чтобы создать diff минимально возможного размера.

Создать diff с помощью алгоритма «patience diff».

Создать diff с помощью алгоритма «histogram diff».

Создать diff с помощью алгоритма «anchored diff».

Этот параметр можно указать несколько раз.

Если строка встречается и в исходном, и в целевом файле только один раз и начинается с <text>, этот алгоритм пытается не выводить её как удалённую или добавленную. Внутри используется алгоритм «patience diff».

Выбрать алгоритм diff. Доступны следующие варианты:

Например, если для переменной diff.algorithm задано нестандартное значение и вы хотите использовать значение по умолчанию, необходимо указать параметр --diff-algorithm=default.

Создать diffstat. По умолчанию для имени файла используется столько места, сколько необходимо, а оставшееся пространство отводится графику. Максимальная ширина по умолчанию равна ширине терминала или 80 столбцам, если терминал не подключён; её можно переопределить с помощью <width>. Ширину части с именами файлов можно ограничить, указав после запятой <name-width> другую ширину или задав diff.statNameWidth=<name-width>. Ширину части с графиком можно ограничить с помощью --stat-graph-width=<graph-width> или задав diff.statGraphWidth=<graph-width>. Параметры --stat и --stat-graph-width влияют на все команды, создающие график статистики, тогда как параметры diff.statNameWidth и diff.statGraphWidth не влияют на git format-patch. Указав третий параметр <count>, можно ограничить вывод первыми <count> строками; если строк больше, после них выводится ....

Эти параметры также можно задавать по отдельности с помощью --stat-width=<width>, --stat-name-width=<name-width> и --stat-count=<count>.

Вывести краткую сводку расширенной информации заголовка, например о создании или удалении файлов («new» или «gone», необязательно +l для символической ссылки) и изменении режима (+x или -x при добавлении или удалении бита исполняемого файла соответственно) в diffstat. Информация размещается между частью с именами файлов и графиком. Подразумевает --stat.

Похож на --stat, но показывает число добавленных и удалённых строк в десятичной записи, а имена путей выводит без сокращений, что удобнее для машинной обработки. Для двоичных файлов вместо сообщения 0 0 выводятся два значения -.

Вывести только последнюю строку формата --stat, содержащую общее число изменённых файлов, а также число добавленных и удалённых строк.

Вывести распределение относительного объёма изменений для каждого подкаталога. Поведение параметра --dirstat можно настроить, передав ему список параметров, разделённых запятыми. Значения по умолчанию задаются переменной конфигурации diff.dirstat (см. git-config[1]). Доступны следующие параметры:

Пример: следующая команда подсчитает изменённые файлы, игнорируя каталоги, на которые приходится менее 10% от общего числа изменённых файлов, и суммируя показатели вложенных каталогов для родительских каталогов: --dirstat=files,10,cumulative.

Синоним для --dirstat=cumulative.

Синоним для --dirstat=files,<param>,....

Вывести краткую сводку расширенной информации заголовка, например о создании файлов, переименованиях и изменениях режима.

Синоним для -p --stat.

Если указан параметр --raw, --numstat, --name-only или --name-status, не изменять имена путей и использовать NUL-символы в качестве разделителей полей вывода.

Без этого параметра имена путей с «нестандартными» символами заключаются в кавычки, как описано для переменной конфигурации core.quotePath (см. git-config[1]).

Показывать только имя каждого изменённого файла в дереве после применения изменений. Имена файлов часто кодируются в UTF-8. Дополнительные сведения см. в обсуждении кодировки на странице руководства git-log[1].

Показывать только имена и состояния изменённых файлов. Значение букв состояния описано в разделе о параметре --diff-filter. Как и при использовании --name-only, имена файлов часто кодируются в UTF-8.

Указать способ отображения различий в подмодулях. Если указано значение --submodule=short, используется формат short. В этом формате показываются только имена коммитов в начале и конце диапазона. Если указано значение --submodule или --submodule=log, используется формат log. В этом формате перечисляются коммиты в диапазоне, как это делает команда summary из git-submodule[1]. Если указано значение --submodule=diff, используется формат diff. В этом формате встроенный diff показывает изменения содержимого подмодуля в диапазоне коммитов. По умолчанию используется diff.submodule или формат short, если параметр конфигурации не задан.

Показывать diff с цветовым оформлением. Значение --color (то есть без =<when>) эквивалентно --color=always. <when> может принимать значения always, never или auto.

Отключить цветовое оформление diff. Эквивалентно --color=never.

Перемещённые строки кода выделяются другим цветом. Если параметр не указан, значением <mode> по умолчанию является no; если параметр указан без режима, используется zebra. Режим должен принимать одно из следующих значений:

Отключить обнаружение перемещений. Этот параметр можно использовать для переопределения настроек конфигурации. Он эквивалентен --color-moved=no.

Этот параметр определяет, как игнорируются пробелы при обнаружении перемещений для --color-moved. Эти режимы можно указать списком через запятую:

Не игнорировать пробелы при обнаружении перемещений. Этот параметр можно использовать для переопределения настроек конфигурации. Он эквивалентен --color-moved-ws=no.

По умолчанию слова разделяются пробелами; см. описание --word-diff-regex ниже. Значение <mode> по умолчанию — plain; допустимы следующие варианты:

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

Параметр --word-diff берёт тот же построчный diff, который создаётся без этого параметра, и вычисляет изменения по словам внутри каждого фрагмента. Это может привести к созданию diff большего размера, чем при использовании специального инструмента для сравнения по словам. Если в будущем Git получит другую реализацию, вывод может измениться. Обратите внимание: это похоже на параметр --diff-algorithm, который также может изменить вывод.

Использовать <regex> для определения слова вместо того, чтобы считать словом последовательности символов, не являющихся пробельными. Также подразумевает --word-diff, если этот параметр ещё не включён.

Каждое неперекрывающееся совпадение с <regex> считается словом. Всё, что находится между совпадениями, считается пробелами и игнорируется(!) при поиске различий. Возможно, в регулярное выражение стоит добавить |[^[:space:]], чтобы оно соответствовало всем непробельным символам. Совпадение, содержащее символ перевода строки, молча обрезается(!) на этом символе.

Например, --word-diff-regex=. будет считать каждую букву отдельным словом и, соответственно, показывать различия посимвольно.

Регулярное выражение также можно задать с помощью драйвера diff или параметра конфигурации; см. gitattributes[5] или git-config[1]. Явно указанное выражение переопределяет любые настройки драйвера diff или конфигурации. Драйверы diff переопределяют настройки конфигурации.

Эквивалентно --word-diff=color и (если задано регулярное выражение) --word-diff-regex=<regex>.

Отключить обнаружение переименований, даже если в файле конфигурации оно включено по умолчанию.

Указывает, следует ли использовать пустые блобы в качестве источника переименования.

Выдать предупреждение, если изменения добавляют маркеры конфликтов или ошибки в пробелах. То, что считается ошибками в пробелах, определяется конфигурацией core.whitespace. По умолчанию ошибками в пробелах считаются конечные пробелы (включая строки, состоящие только из пробелов) и символ пробела, за которым непосредственно следует символ табуляции во вводном отступе строки. Если обнаружены проблемы, завершить работу с ненулевым кодом возврата. Несовместимо с --exit-code.

Подсвечивать ошибки в пробелах в строках context, old или new различий. Несколько значений разделяются запятыми, none сбрасывает предыдущие значения, default сбрасывает список до new, а all — это сокращение для old,new,context. Если этот параметр не задан, а переменная конфигурации diff.wsErrorHighlight не установлена, подсвечиваются только ошибки в пробелах в строках new. Ошибки в пробелах выделяются цветом color.diff.whitespace.

Вместо первых нескольких символов выводить полные имена объектов blob исходного и конечного состояний в строке «index» при генерации вывода в формате патча.

Помимо --full-index, выводить бинарный diff, который можно применить с помощью git-apply. Подразумевает --patch.

Вместо полного 40-байтового шестнадцатеричного имени объекта в выводе формата diff-raw и строках заголовка diff-tree выводить кратчайший префикс длиной не менее <n> шестнадцатеричных цифр, однозначно обозначающий объект. В формате вывода diff-patch --full-index имеет более высокий приоритет: то есть, если указан --full-index, будут показаны полные имена blob независимо от --abbrev. Число цифр, отличное от значения по умолчанию, можно задать с помощью --abbrev=<n>.

Разбивать полные переписывания на пары удаления и создания. Это служит двум целям:

Параметр влияет на то, как изменение, представляющее собой полное переписывание файла, отображается: не как серия перемешанных удалений и вставок с небольшим количеством строк, случайно совпадающих текстуально и служащих контекстом, а как одно удаление всего старого содержимого с последующей одной вставкой всего нового. Число <m> управляет этим аспектом параметра -B (по умолчанию 60%). -B/70% указывает, что в результате должно сохраниться менее 30% исходного содержимого, чтобы Git счёл изменение полным переписыванием (в противном случае итоговый патч будет представлять собой серию перемешанных удалений и вставок со строками контекста).

При использовании вместе с -M полностью переписанный файл также считается источником переименования (обычно -M рассматривает как источник переименования только исчезнувший файл), а число <n> управляет этим аспектом параметра -B (по умолчанию 50%). -B20% указывает, что изменение, при котором добавления и удаления составляют 20% или более от размера файла, может быть выбрано как возможный источник переименования в другой файл.

Обнаруживать переименования. Если указано <n>, оно задаёт порог индекса сходства (то есть объём добавлений и удалений относительно размера файла). Например, -M90% означает, что Git должен считать пару «удаление/добавление» переименованием, если файл изменился менее чем на 10%. Если знак % отсутствует, число трактуется как дробь с десятичной точкой перед ним. То есть -M5 становится 0.5 и, таким образом, эквивалентно -M50%. Аналогично, -M05 эквивалентно -M5%. Чтобы обнаруживать только точные переименования, используйте -M100%. Индекс сходства по умолчанию равен 50%.

Обнаруживать копирования, а также переименования. См. также --find-copies-harder. Если указано <n>, оно имеет то же значение, что и для -M<n>.

По умолчанию, ради производительности, параметр -C обнаруживает копирования, только если исходный файл копии был изменён в том же наборе изменений. Этот флаг заставляет команду проверять неизменённые файлы как возможные источники копирования. Для больших проектов эта операция очень затратна, поэтому используйте её с осторожностью. Несколько параметров -C дают тот же эффект.

Не выводить исходное содержимое для удалённых файлов, то есть печатать только заголовок, но не различия между исходным и /dev/null. Полученный патч не предназначен для применения с помощью patch или git apply; этот параметр предназначен исключительно для тех, кто хочет сосредоточиться на проверке текста после изменения. Кроме того, в выводе явно недостаточно информации, чтобы применить такой патч в обратном направлении, даже вручную, отсюда и название параметра.

При использовании вместе с -B также не выводить исходное содержимое в части удаления пары «удаление/создание».

Параметры -M и -C включают предварительные этапы, позволяющие с небольшими затратами обнаружить некоторые переименования и копирования, за которыми следует исчерпывающий этап, сравнивающий все оставшиеся несопоставленные целевые файлы со всеми подходящими исходными. (Для переименований подходят только оставшиеся несопоставленные исходные файлы; для копирований подходят все исходные файлы.) Для N исходных и целевых файлов эта исчерпывающая проверка имеет сложность O(N^2). Этот параметр не позволяет выполнять исчерпывающий этап обнаружения переименований и копирований, если число задействованных исходных и целевых файлов превышает указанное значение. Значение по умолчанию — diff.renameLimit. Обратите внимание: значение 0 означает отсутствие ограничения.

Выбирать только добавленные (A), скопированные (C), удалённые (D), изменённые (M), переименованные (R) файлы, файлы с изменившимся типом (например, обычный файл, символическая ссылка, подмодуль и т. д.; T), неслитые файлы (U), неизвестные файлы (X) или файлы с нарушенной парой (B). Можно использовать любую комбинацию символов фильтра (в том числе пустую). Если к комбинации добавлено * (все или ничего), выбираются все пути, если в сравнении есть хотя бы один файл, соответствующий остальным критериям; если таких файлов нет, ничего не выбирается.

Кроме того, эти заглавные буквы можно заменить строчными, чтобы исключить соответствующие файлы. Например, --diff-filter=ad исключает добавленные и удалённые пути.

Обратите внимание, что не все различия могут включать все типы. Например, записи о копировании и переименовании отсутствуют, если обнаружение этих типов отключено.

Искать различия, меняющие число вхождений указанной <string> в файле (то есть добавление или удаление). Предназначено для использования в скриптах.

Это полезно, когда вы ищете точный блок кода (например, структуру) и хотите узнать историю этого блока с момента его появления: используйте эту возможность итеративно, передавая интересующий блок из исходного содержимого обратно в -S, и продолжайте, пока не получите самую первую версию блока.

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

Искать различия, в тексте патча которых есть добавленные или удалённые строки, соответствующие <regex>.

Чтобы показать разницу между -S<regex> --pickaxe-regex и -G<regex>, рассмотрим коммит со следующим diff в том же файле:

+    return frotz(nitfol, two->ptr, 1, 0);
...
-    hit = frotz(nitfol, mf2.ptr, 1, 0);

Команда git log -G"frotz\(nitfol" покажет этот коммит, а git log -S"frotz\(nitfol" --pickaxe-regex — нет (поскольку число вхождений этой строки не изменилось).

Если не задан --text, патчи двоичных файлов без фильтра textconv будут игнорироваться.

Дополнительные сведения см. в разделе pickaxe руководства gitdiffcore[7].

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

Объектом может быть blob или коммит подмодуля. Параметр подразумевает -t в git-log, чтобы также находить деревья.

Когда -S или -G обнаруживает изменение, показывать все изменения в этом наборе изменений, а не только файлы, содержащие изменение в <string>.

Обрабатывать <string>, переданный в -S, как расширенное регулярное выражение POSIX для сопоставления.

Управлять порядком вывода файлов. Этот параметр имеет приоритет над переменной конфигурации diff.orderFile (см. git-config[1]). Чтобы отменить diff.orderFile, используйте -O/dev/null.

Порядок вывода определяется порядком шаблонов glob в <orderfile>. Сначала выводятся все файлы, пути которых соответствуют первому шаблону, затем — все файлы, пути которых соответствуют второму шаблону (но не первому), и так далее. В последнюю очередь выводятся файлы, пути которых не соответствуют ни одному шаблону, как если бы в конце файла находился неявный шаблон, совпадающий со всеми путями. Если несколько путей имеют одинаковый приоритет (соответствуют одному и тому же шаблону, но не более ранним шаблонам), они выводятся в обычном порядке относительно друг друга.

Файл <orderfile> разбирается следующим образом:

Синтаксис и семантика шаблонов совпадают с используемыми в fnmatch(3) без флага FNM_PATHNAME, за исключением того, что путь также соответствует шаблону, если после удаления любого числа конечных компонентов пути он соответствует шаблону. Например, шаблон «foo*bar» соответствует «fooasdfbar» и «foo/bar/baz/asdf», но не «foobarx».

Не выводить файлы, расположенные перед указанным <file> (то есть skip to), либо переместить их в конец вывода (то есть rotate to). Эти параметры созданы главным образом для команды git difftool и в других случаях могут быть не очень полезны.

Поменять местами два входных объекта, то есть показать различия между индексом или файлом на диске и содержимым дерева.

Если команда запущена из подкаталога проекта, с помощью этого параметра можно исключить изменения за пределами каталога и выводить пути относительно него. Если вы находитесь не в подкаталоге (например, в пустом репозитории), можно указать подкаталог, относительно которого нужно выводить результат, передав <path> в качестве аргумента. --no-relative можно использовать, чтобы отменить действие параметра конфигурации diff.relative и предыдущего параметра --relative.

Считать все файлы текстовыми.

При сравнении игнорировать возврат каретки в конце строки.

Игнорировать изменения пробелов в конце строки.

Игнорировать изменения количества пробельных символов. Игнорируются пробелы в конце строки, а все остальные последовательности из одного или нескольких пробельных символов считаются эквивалентными.

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

Игнорировать изменения, строки которых полностью пусты.

Игнорировать изменения, если все их строки соответствуют <regex>. Этот параметр можно указывать несколько раз.

Показывать контекст между фрагментами diff размером до указанного <number> строк, объединяя расположенные близко друг к другу фрагменты. По умолчанию используется diff.interHunkContext или 0, если параметр конфигурации не задан.

Показывать всю функцию в качестве строк контекста для каждого изменения. Имена функций определяются так же, как при формировании заголовков фрагментов патча с помощью git diff (см. раздел «Определение пользовательского заголовка фрагмента» в gitattributes[5]).

Завершать работу программы с кодами, аналогичными diff(1). То есть возвращать 1, если есть различия, и 0, если различий нет.

Отключить весь вывод программы. Подразумевает --exit-code. Запрещает выполнение внешних обработчиков diff, код возврата которых не считается надёжным, то есть если соответствующий параметр конфигурации diff.trustExitCode или diff.<driver>.trustExitCode либо переменная окружения GIT_EXTERNAL_DIFF_TRUST_EXIT_CODE имеет значение false.

Разрешить выполнение внешнего обработчика diff. Если вы задали внешний драйвер diff с помощью gitattributes[5], этот параметр необходимо использовать с git-log[1] и связанными командами.

Запретить внешние драйверы diff.

Разрешить (или запретить) запуск внешних фильтров преобразования текста при сравнении двоичных файлов. Подробности см. в gitattributes[5]. Поскольку фильтры textconv обычно выполняют одностороннее преобразование, полученный diff удобен для чтения человеком, но не может быть применён. Поэтому фильтры textconv по умолчанию включены только для git-diff[1] и git-log[1], но не для git-format-patch[1] или низкоуровневых команд diff.

Игнорировать изменения подмодулей при формировании diff. Значение по умолчанию — all. При использовании none подмодуль считается изменённым, если он содержит неотслеживаемые или изменённые файлы либо его HEAD отличается от коммита, записанного в суперпроекте. Этот параметр можно использовать, чтобы переопределить любые настройки параметра ignore в git-config[1] или gitmodules[5]. При использовании untracked подмодули не считаются изменёнными, если содержат только неотслеживаемые данные (однако они всё равно проверяются на наличие изменённых данных). При использовании dirty игнорируются все изменения рабочего дерева подмодулей и показываются только изменения коммитов, сохранённых в суперпроекте (такое поведение использовалось до версии 1.7.0). При использовании all скрываются все изменения подмодулей.

Показывать указанный префикс исходного файла <prefix> вместо «a/».

Показывать указанный префикс целевого файла <prefix> вместо «b/».

Не показывать префиксы исходных и целевых файлов.

Использовать стандартные префиксы исходных и целевых файлов («a/» и «b/»). Этот параметр имеет приоритет над такими переменными конфигурации, как diff.noprefix, diff.srcPrefix, diff.dstPrefix и diff.mnemonicPrefix (см. git-config[1]).

Добавлять дополнительный <prefix> в начало каждой строки вывода.

По умолчанию записи, добавленные с помощью git add -N, отображаются как существующий пустой файл в git diff и как новый файл в git diff --cached. Этот параметр заставляет отображать такую запись как новый файл в git diff и как отсутствующую в git diff --cached. Это поведение можно отменить с помощью --ita-visible-in-index. Оба параметра являются экспериментальными и могут быть удалены в будущем.

Для каждой спецификации пути, заданной в командной строке, спускаться не более чем на <depth> уровней каталогов. Значение -1 означает отсутствие ограничений. Нельзя использовать совместно с подстановочными знаками в спецификации пути. Для дерева, содержащего foo/bar/baz, в следующем списке показаны совпадения, генерируемые каждым набором параметров:

Если спецификация пути не задана, глубина измеряется так, как если бы были указаны все записи верхнего уровня. Обратите внимание, что это отличается от измерения от корня: --max-depth=0 всё равно вернёт foo. Это позволяет ограничить глубину, запросив при этом подмножество записей верхнего уровня.

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

Сравнение соответственно с версией «base», «нашей веткой» или «их веткой». При использовании этих параметров различия для слитых записей не отображаются.

По умолчанию выполняется сравнение с нашей веткой (-2) и путями, разрешёнными без конфликтов. Параметр -0 можно указать, чтобы не выводить различия для неслитых записей, а просто показать «Unmerged».

Сравнивает файл рабочего дерева с этапом 2 (наша ветка) и этапом 3 (их ветка) и выводит объединённый diff, подобно тому, как diff-tree отображает коммит слияния с этими флагами.

Не выводить сообщения даже для несуществующих файлов

сравнивает <tree-ish> и файлы в файловой системе.

сравнивает <tree-ish> и индекс.

сравнивает деревья, указанные двумя аргументами.

сравнивает индекс и файлы в файловой системе.