git-diff-index

Создать патч (см. Создание текста патча с помощью -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.

Создать статистику diff. По умолчанию для имени файла используется столько места, сколько необходимо, а остальное отводится под график. Максимальная ширина по умолчанию равна ширине терминала или 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 при добавлении или удалении бита исполняемости соответственно) в статистике diff. Эта информация помещается между частью с именем файла и частью с графиком. Подразумевает --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» при создании вывода в формате patch.

В дополнение к --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% исходного содержимого (в противном случае итоговый patch будет представлять собой серию удалений и вставок, перемежающихся строками контекста).

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

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

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

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

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

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

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

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

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

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

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

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

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

Искать различия, в тексте patch которых есть добавленные или удалённые строки, соответствующие <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, patch двоичных файлов без фильтра 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 и вряд ли будут полезны в других случаях.

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

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

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

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

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

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

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

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

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

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

Показывать всю функцию в качестве строк контекста для каждого изменения. Имена функций определяются так же, как git diff формирует заголовки блоков patch (см. раздел «Определение пользовательского заголовка блока» в 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. Оба параметра являются экспериментальными и могут быть удалены в будущем.

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

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

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

Идентификатор объекта дерева, с которым выполняется сравнение.

Не учитывать файл на диске.

Вместо прямого сравнения <tree-ish> использовать базу слияния между <tree-ish> и HEAD. <tree-ish> должен быть коммитом.

По умолчанию файлы, записанные в индекс, но не извлечённые в рабочее дерево, считаются удалёнными. Этот флаг заставляет git diff-index считать все не извлечённые файлы актуальными.

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

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

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

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