українська мова ▾ Topics ▾ Latest version ▾ git-diff last updated in 2.52.0

НАЗВА

git-diff - Показати зміни між коммітами, комітом та робочим деревом тощо

СИНОПСИС

git diff [<options>] [<commit>] [--] [<path>…​]
git diff [<options>] --cached [--merge-base] [<commit>] [--] [<path>…​]
git diff [<options>] [--merge-base] <commit> [<commit>…​] <commit> [--] [<path>…​]
git diff [<options>] <commit>...<commit> [--] [<path>…​]
git diff [<options>] <blob> <blob>
git diff [<options>] --no-index [--] <path> <path> [<pathspec>…​]

ОПИС

Відображати зміни між робочим деревом та індексом або деревом, зміни між індексом та деревом, зміни між двома деревами, зміни, що виникають в результаті злиття, зміни між двома blob-об’єктами або зміни між двома файлами на диску.

git diff [<options>] [--] [<path>...]

Ця форма призначена для перегляду змін, які ви внесли відносно індексу (область проміжного зберігання для наступного коміту). Іншими словами, відмінності – це те, що ви могли б_ сказати Git додати до індексу, але досі цього не зробили. Ви можете проміжним способом додати ці зміни, використовуючи git-add[1].

git diff [<options>] --no-index [--] <path> <path> [<pathspec>...]

Ця форма призначена для порівняння двох заданих шляхів у файловій системі. Ви можете пропустити опцію --no-index, якщо ви виконуєте команду в робочому дереві, контрольованому Git, і принаймні один зі шляхів вказує за межі робочого дерева, або якщо ви виконуєте команду за межами робочого дерева, контрольованого Git. Ця форма передбачає --exit-code. Якщо обидва шляхи вказують на каталоги, можна надати додаткові специфікації шляхів. Вони обмежать файли, що входять до різниці. Усі такі специфікації шляхів мають бути відносними, оскільки вони застосовуються до обох сторін різниці.

git diff [<options>] --cached [--merge-base] [<commit>] [--] [<path>...]

Ця форма призначена для перегляду змін, які ви проіндексували для наступного коміту відносно названого <commit>. Зазвичай вам потрібно порівняти їх з останнім комітом, тому, якщо ви не вкажете <commit>, за замовчуванням використовується значення HEAD. Якщо HEAD не існує (наприклад, ненароджені гілки) і <commit> не вказано, буде показано всі проіндексовані зміни. --staged є синонімом --cached.

Якщо вказано --merge-base, замість використання <commit> використовується база злиття <commit> та HEAD. git diff --cached --merge-base A еквівалентно git diff --cached $(git merge-base A HEAD).

git diff [<options>] [--merge-base] <commit> [--] [<path>...]

Ця форма призначена для перегляду змін у вашому робочому дереві відносно названого <commit>. Ви можете використовувати HEAD для порівняння його з останнім комітом або назву гілки для порівняння з кінчиком іншої гілки.

Якщо вказано --merge-base, замість використання <commit> використовується база злиття <commit> та HEAD. git diff --merge-base A еквівалентно git diff $(git merge-base A HEAD).

git diff [<options>] [--merge-base] <commit> <commit> [--] [<path>...]

Це для перегляду змін між двома довільними <commit>.

Якщо вказано --merge-base, використовувати базу злиття двох комітів для сторони "до". git diff --merge-base A B еквівалентно git diff $(git merge-base A B) B.

git diff [<options>] <commit> <commit>...<commit> [--] [<path>...]

Ця форма призначена для перегляду результатів коміту злиття. Перший у списку <commit> має бути самим комітом злиття; решта два або більше комітів повинні бути його батьківськими. Зручними способами створення бажаного набору ревізій є використання суфіксів @ та ^!. Якщо A є комітом злиття, то git diff A A^@, git diff A^! та git show A дають однакову комбіновану різницю.

git diff [<options>] <commit>..<commit> [--] [<path>...]

Це синонім попередньої форми (без ..) для перегляду змін між двома довільними <commit>. Якщо <commit> з одного боку пропустити, це матиме той самий ефект, що й використання HEAD замість цього.

git diff [<options>] <commit>...<commit> [--] [<path>...]

Ця форма призначена для перегляду змін у гілці, що містить <commit> і аж до другого <commit>, починаючи зі спільного предка обох <commit>. git diff A...B еквівалентно git diff $(git merge-base A B) B. Ви можете пропустити будь-який з <commit>, що матиме той самий ефект, що й використання HEAD.

Якщо ви робите щось екзотичне, слід зазначити, що всі <commit> у наведеному вище описі, за винятком випадку --merge-base та двох останніх форм, які використовують нотації .., можуть бути будь-якими <tree>. Дерево, що нас цікавить, це те, на яке вказує посилання з назвою AUTO_MERGE, яке записується стратегією злиття ort після виникнення конфліктів злиття (див. git-merge[1]). Порівняння робочого дерева з AUTO_MERGE показує зміни, які ви внесли до цього часу для вирішення текстових конфліктів (див. приклади нижче).

Для отримання повнішого списку способів написання <commit> див. розділ "ВИЗНАЧЕННЯ РЕВІЗІЙ" у gitrevisions[7]. Однак, diff стосується порівняння двох кінцевих точок, а не діапазонів, а позначення діапазонів (<commit>..<commit> та <commit>...<commit>) не означають діапазон, як визначено в розділі "ВИЗНАЧЕННЯ ДІАПАЗОНІВ" у gitrevisions[7].

git diff [<options>] <blob> <blob>

Ця форма призначена для перегляду відмінностей між необробленим вмістом двох blob-об’єктів.

ОПЦІЇ

-p
-u
--patch

Згенерувати патч (див. Генерація тексту патча за допомогою -p). Це значення за замовчуванням.

-s
--no-patch

Придушити весь вивід з механізму різниці. Корисно для команд типу git show, які показують патч за замовчуванням, щоб приглушити їхній вивід або скасувати дію опцій типу --patch, --stat, зазначених раніше в командному рядку в псевдонімі.

-U<n>
--unified=<n>

Генерувати різниці з <n> рядками контексту замість звичайних трьох. Implies --patch.

--output=<файл>

Вивід у певний файл замість stdout.

--output-indicator-new=<char>
--output-indicator-old=<char>
--output-indicator-context=<char>

Вкажіть символ, який використовується для позначення нових, старих або контекстних рядків у згенерованому патчі. Зазвичай це +, - та '' відповідно.

--raw

Згенерувати різницю у необробленому форматі.

--patch-with-raw

Синонім до слова -p --raw.

--indent-heuristic

Увімкнути евристику, яка зсуває межі різниці фрагментів, щоб зробити патчі легшими для читання. Це значення за замовчуванням.

--no-indent-heuristic

Вимкнути евристику відступів.

--minimal

Витратьте додатковий час, щоб переконатися, що отримано найменшу можливу різницю.

--patience

Згенеруйте різницю за допомогою алгоритму "різниця терпіння".

--histogram

Згенеруйте різницю за допомогою алгоритму "різниця гістограми".

--anchored=<text>

Згенеруйте різницю за допомогою алгоритму "закріпленої різниці".

Цей параметр можна вказати більше одного разу.

Якщо рядок існує як у джерелі, так і в пункті призначення, існує лише один раз і починається з <текст>, цей алгоритм намагається запобігти його появі як видалення або додавання у виводі. Він внутрішньо використовує алгоритм "різниці терпіння".

--diff-algorithm=(patience|minimal|histogram|myers)

Виберіть алгоритм порівняння. Варіанти такі:

default
myers

Базовий алгоритм жадібного різниці. Наразі це алгоритм за замовчуванням.

minimal

Витратьте додатковий час, щоб переконатися, що отримано найменшу можливу різницю.

patience

Використовуйте алгоритм "різниця терпіння" під час створення патчів.

histogram

Цей алгоритм розширює алгоритм терпіння для «підтримки рідко зустрічаються поширених елементів».

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

--stat[=<width>[,<name-width>[,<count>]]]

Згенерувати 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=<ширина>, --stat-name-width=<ширина-назви> та --stat-count=<кількість>.

--compact-summary

Вивести стислий виклад розширеної інформації заголовка, такої як створення або видалення файлів ("new" або "gone", необов’язково +l, якщо це символічне посилання) та зміни режиму (+x або -x для додавання або видалення виконуваного біта відповідно) у diffstat. Інформація розміщується між частиною імені файлу та частиною графу. Має на увазі --stat.

--numstat

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

--shortstat

Виведіть лише останній рядок формату --stat, що містить загальну кількість змінених файлів, а також кількість доданих та видалених рядків.

-X [<param>,...]
--dirstat[=<param>,...]

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

changes

Обчисліть числа dirstat, підрахувавши рядки, які були видалені з джерела або додані до місця призначення. Це ігнорує кількість чистих переміщень коду у файлі. Іншими словами, перестановка рядків у файлі враховується не так часто, як інші зміни. Це поведінка за замовчуванням, коли не задано параметр.

lines

Обчисліть числа dirstat, виконавши звичайний рядковий аналіз різниці та підсумувавши кількість видалених/доданих рядків. (Для бінарних файлів рахуйте 64-байтові фрагменти, оскільки бінарні файли не мають природного поняття рядків). Це дорожча поведінка --dirstat, ніж поведінка changes, але вона враховує переставлені рядки у файлі так само, як і інші зміни. Отриманий результат узгоджується з тим, що ви отримуєте від інших опцій --*stat.

files

Обчисліть числа dirstat, підрахувавши кількість змінених файлів. Кожен змінений файл враховується однаково в аналізі dirstat. Це найдешевша з точки зору обчислень поведінка --dirstat, оскільки взагалі не потрібно переглядати вміст файлу.

cumulative

Також підраховуйте зміни в дочірньому каталозі для батьківського каталогу. Зверніть увагу, що під час використання cumulative сума відсотків, що повідомляються, може перевищувати 100%. Поведінку за замовчуванням (некумулятивну) можна вказати за допомогою параметра noncumulative.

<limit>

Цілочисельний параметр визначає граничний відсоток (за замовчуванням 3%). Каталоги, що вносять менше змін, ніж цей відсоток, не відображаються у виводі.

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

--cumulative

Синонім до --dirstat=cumulative.

--dirstat-by-file[=<param>,...]

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

--summary

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

--patch-with-stat

Синонім до -p --stat.

-z

Коли було використано --raw, --numstat, --name-only або --name-status враховано, не змінюйте шляхи та використовуйте NUL як термінатори вихідних полів.

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

--name-only

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

--name-status

Показувати лише ім’я(імена) та стан кожного зміненого файлу. Дивіться опис опції --diff-filter щодо значення літер стану. Так само, як і --name-only, імена файлів часто кодуються в UTF-8.

--submodule[=<формат>]

Вкажіть, як відображаються відмінності в підмодулях. При вказівці --submodule=short використовується формат short. Цей формат показує лише назви комітів на початку та в кінці діапазону. Коли вказано --submodule або --submodule=log, використовується формат log. Цей формат відображає коміти в діапазоні, подібно до git-submodule[1] summary. Коли вказано --submodule=diff, використовується формат diff. Цей формат показує вбудовану різницю змін у вмісті підмодуля між діапазоном комітів. За замовчуванням використовується формат diff.submodule або short, якщо параметр конфігурації не встановлено.

--color[=<when>]

Показати кольорову різницю. --color (тобто без =<when>) те саме, що й --color=always. <when> може бути одним із always, never або auto. Це можна змінити за допомогою color.ui та color.diff налаштування конфігурації.