Setup and Config
Getting and Creating Projects
Basic Snapshotting
Branching and Merging
Sharing and Updating Projects
Inspection and Comparison
Patching
Debugging
External Systems
Server Admin
Guides
- gitattributes
- Command-line interface conventions
- Everyday Git
- Frequently Asked Questions (FAQ)
- Glossary
- Hooks
- gitignore
- gitmodules
- Revisions
- Submodules
- Tutorial
- Workflows
- All guides...
Administration
Plumbing Commands
-
2.51.0
2025-08-18
- 2.49.1 → 2.50.1 no changes
-
2.49.0
2025-03-14
- 2.48.1 → 2.48.2 no changes
-
2.48.0
2025-01-10
- 2.46.2 → 2.47.3 no changes
-
2.46.1
2024-09-13
-
2.46.0
2024-07-29
- 2.45.4 no changes
-
2.45.3
2024-11-26
- 2.45.1 → 2.45.2 no changes
-
2.45.0
2024-04-29
- 2.44.1 → 2.44.4 no changes
-
2.44.0
2024-02-23
- 2.43.1 → 2.43.7 no changes
-
2.43.0
2023-11-20
- 2.42.2 → 2.42.4 no changes
-
2.42.1
2023-11-02
-
2.42.0
2023-08-21
- 2.41.1 → 2.41.3 no changes
-
2.41.0
2023-06-01
- 2.40.1 → 2.40.4 no changes
-
2.40.0
2023-03-12
- 2.37.3 → 2.39.5 no changes
-
2.37.2
2022-08-11
- 2.36.1 → 2.37.1 no changes
-
2.36.0
2022-04-18
- 2.35.1 → 2.35.8 no changes
-
2.35.0
2022-01-24
- 2.34.1 → 2.34.8 no changes
-
2.34.0
2021-11-15
- 2.33.3 → 2.33.8 no changes
-
2.33.2
2022-03-23
-
2.33.1
2021-10-12
-
2.33.0
2021-08-16
- 2.32.1 → 2.32.7 no changes
-
2.32.0
2021-06-06
- 2.31.1 → 2.31.8 no changes
-
2.31.0
2021-03-15
- 2.30.1 → 2.30.9 no changes
-
2.30.0
2020-12-27
- 2.29.1 → 2.29.3 no changes
-
2.29.0
2020-10-19
- 2.28.1 no changes
-
2.28.0
2020-07-27
- 2.27.1 no changes
-
2.27.0
2020-06-01
- 2.26.1 → 2.26.3 no changes
-
2.26.0
2020-03-22
- 2.25.2 → 2.25.5 no changes
-
2.25.1
2020-02-17
-
2.25.0
2020-01-13
- 2.24.1 → 2.24.4 no changes
-
2.24.0
2019-11-04
- 2.22.1 → 2.23.4 no changes
-
2.22.0
2019-06-07
- 2.21.1 → 2.21.4 no changes
-
2.21.0
2019-02-24
- 2.20.1 → 2.20.5 no changes
-
2.20.0
2018-12-09
- 2.19.1 → 2.19.6 no changes
-
2.19.0
2018-09-10
- 2.18.1 → 2.18.5 no changes
-
2.18.0
2018-06-21
- 2.17.1 → 2.17.6 no changes
-
2.17.0
2018-04-02
-
2.16.6
2019-12-06
-
2.15.4
2019-12-06
-
2.14.6
2019-12-06
-
2.13.7
2018-05-22
-
2.12.5
2017-09-22
-
2.11.4
2017-09-22
-
2.10.5
2017-09-22
-
2.9.5
2017-07-30
-
2.8.6
2017-07-30
- 2.7.6 no changes
-
2.6.7
2017-05-05
-
2.5.6
2017-05-05
-
2.4.12
2017-05-05
-
2.3.10
2015-09-28
-
2.2.3
2015-09-04
-
2.1.4
2014-12-17
-
2.0.5
2014-12-17
СИНОПСИС
git diff-tree [--stdin] [-m] [-s] [-v] [--no-commit-id] [--pretty] [-t] [-r] [-c | --cc] [--combined-all-paths] [--root] [--merge-base] [<common-diff-options>] <tree-ish> [<tree-ish>] [<path>…]
ОПИС
Порівняйте вміст та режим роботи блобів, знайдених за допомогою двох об’єктів дерева.
Якщо задано лише один <tree-ish>, коміт порівнюється з його батьківськими елементами (див. --stdin нижче).
Зверніть увагу, що git diff-tree може використовувати дерево, інкапсульоване в об’єкті commit.
ОПЦІЇ
-
-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
. -
--no-color
-
Вимкніть кольорову різницю. Це те саме, що
--color=never
. -
--color-moved
[=
<режим>] -
Переміщені рядки коду забарвлюються по-різному. <режим> за замовчуванням має значення
no
, якщо опція не вказана та доzebra
, якщо вказано опцію без режиму. Режим має бути одним із таких:-
no
-
Переміщені рядки не виділяються.
-
default
-
Є синонімом слова «зебра». У майбутньому це може змінитися на більш розумний режим.
-
plain
-
Будь-який рядок, доданий в одному місці та видалений в іншому, буде забарвлений за допомогою
color.diff.newMoved
. Аналогічно,color.diff.oldMoved
буде використано для видалених рядків, доданих деінде в різниці. Цей режим виявляє будь-який переміщений рядок, але він не дуже корисний під час перегляду, щоб визначити, чи блок коду був переміщений без перестановки. -
blocks
-
Блоки переміщеного тексту довжиною щонайменше 20 буквено-цифрових символів виявляються жадібно. Виявлені блоки зафарбовуються кольором
color.diff.
(old
|new
)Moved
. Сусідні блоки неможливо розрізнити. -
zebra
-
Блоки переміщеного тексту виявляються як у режимі
blocks
. Блоки зафарбовуються кольоромcolor.diff.
(old
|new
)Moved
абоcolor.diff.
(old
|new
)MovedAlternative
. Зміна між двома кольорами вказує на виявлення нового блоку. -
dimmed-zebra
-
Подібно до
zebra
, але виконується додаткове затемнення нецікавих частин переміщеного коду. Лінії, що межують з двома суміжними блоками, вважаються цікавими, решта – нецікавими.dimmed_zebra
– застарілий синонім.
-
-
--no-color-moved
-
Вимкніть виявлення руху. Це можна використовувати для зміни налаштувань конфігурації. Це те саме, що й
--color-moved=no
. -
--color-moved-ws=
<режим>,...
-
Це налаштовує, як пробіли ігноруються під час виконання виявлення переміщення для
--color-moved
. Ці режими можна вказати у вигляді списку, розділеного комами:-
no
-
Не ігноруйте пробіли під час виявлення руху.
-
ignore-space-at-eol
-
Ігнорувати зміни пробілів в кінці циклу.
-
ignore-space-change
-
Ігнорувати зміни кількості пробілів. Це ігнорує пробіли в кінці рядка та вважає всі інші послідовності з одного або кількох пробілних символів еквівалентними.
-
ignore-all-space
-
Ігнорувати пробіли під час порівняння рядків. Це ігнорує відмінності, навіть якщо один рядок має пробіли, а інший їх не має.
-
allow-indentation-change
-
Спочатку ігноруйте будь-які пробіли у виявленні переміщення, а потім групуйте переміщені блоки коду в блок, лише якщо зміна пробілів однакова для кожного рядка. Це несумісно з іншими режимами.
-
-
--no-color-moved-ws
-
Не ігноруйте пробіли під час виявлення переміщення. Це можна використовувати для перевизначення налаштувань конфігурації. Це те саме, що
--color-moved-ws=no
. -
--word-diff
[=
<mode>] -
За замовчуванням слова розділяються пробілами; див.
--word-diff-regex
нижче. <mode> за замовчуванням має значенняplain
і має бути одним із:-
color
-
Виділяє змінені слова, використовуючи лише кольори. Має на увазі
--color
. -
plain
-
Показує слова як [
-removed-
] та{
. Не намагається екранувати роздільники, якщо вони з’являються у вхідних даних, тому вихід може бути неоднозначним.added
} -
porcelain
-
Використовуйте спеціальний рядковий формат, призначений для використання скриптами. Додані/видалені/незмінені прогони виводяться у звичайному уніфікованому форматі різниці, починаючи з символу
+
/-
/` ` на початку рядка та продовжуючи до кінця рядка. Перехід на новий рядок у вхідних даних позначається тильдою~
на окремому рядку. -
none
-
Знову вимкнути різницю слів.
Зверніть увагу, що незважаючи на назву першого режиму, колір використовується для виділення змінених частин у всіх режимах, якщо вони ввімкнені.
-
- --word-diff-regex=<регулярний вираз>
-
Використовуйте <regex>, щоб визначити, що таке слово, замість того, щоб вважати словом рядки, що не є пробілами. Також мається на увазі
--word-diff
, якщо ця опція ще не була ввімкнена.Кожен неперекриваючийся збіг <regex> вважається словом. Будь-що між цими збігами вважається пробілом та ігнорується(!) для цілей пошуку відмінностей. Ви можете додати |[
^
[:space:
]] до вашого регулярного виразу, щоб переконатися, що він відповідає всім символам, які не є пробілами. Збіг, що містить символ нового рядка, непомітно обрізається(!) на місці нового рядка.Наприклад,
--word-diff-regex=.
трактуватиме кожен символ як слово та, відповідно, показуватиме відмінності посимвольно.Регулярний вираз також можна встановити за допомогою драйвера різниці або параметра конфігурації, див. gitattributes[5] або git-config[1]. Його явне вказівка перевизначає будь-який драйвер різниці або параметр конфігурації. Драйвери різниці перевизначають параметри конфігурації.
-
--color-words
[=
<regex>] -
Еквівалентно
--word-diff=color
плюс (якщо було вказано регулярний вираз) --word-diff-regex=<регулярний вираз>. -
--no-renames
-
Вимкніть виявлення перейменування, навіть якщо у файлі конфігурації це встановлено за замовчуванням.
-
--
[no-
]rename-empty
-
Чи використовувати порожні блоби як джерело перейменування.
-
--check
-
Попереджати, якщо зміни призводять до появи маркерів конфлікту або помилок пробілів. Те, що вважається помилками пробілів, контролюється конфігурацією
core.whitespace
. За замовчуванням, кінцеві пробіли (включно з рядками, що складаються виключно з пробілів) та символ пробілу, за яким одразу йде символ табуляції всередині початкового відступу рядка, вважаються помилками пробілів. Виходить з ненульовим статусом, якщо виявлено проблеми. Несумісно з--exit-code
. -
--ws-error-highlight=
<kind> -
Виділяє помилки пробілів у рядках
context
,old
абоnew
різниці. Кілька значень розділяються комами,none
скидає попередні значення,default
скидає список доnew
, аall
– це скорочення відold,new,context
. Якщо цей параметр не вказано, а змінна конфігураціїdiff.wsErrorHighlight
не встановлена, виділяються лише помилки пробілів у рядкахnew
. Помилки пробілів забарвлюються за допомогоюcolor.diff.whitespace
. -
--full-index
-
Замість перших кількох символів, відображати повні назви об’єктів blob до та після зображення в рядку "index" під час створення виводу у форматі патча.
-
--binary
-
Окрім
--full-index
, виведіть бінарний diff, який можна застосувати за допомогоюgit-apply
. Implies--patch
. -
--abbrev
[=
<n>] -
Замість відображення повної 40-байтової шістнадцяткової назви об’єкта у вивідному форматі diff-raw та рядках заголовків diff-tree, відображайте найкоротший префікс довжиною щонайменше <n> шістнадцяткових цифр, який унікально посилається на об’єкт. У вивідному форматі diff-patch
--full-index
має вищий пріоритет, тобто якщо вказано--full-index
, будуть відображатися повні назви блобів незалежно від--abbrev
. Кількість цифр, відмінну від стандартної, можна вказати за допомогою--abbrev=
<n>. -
-B
[<n>][/
<m>] -
--break-rewrites
[=
[<n>][/
<m>]] -
Розбийте повні зміни перезапису на пари видалення та створення. Це служить двом цілям:
Це впливає на те, як зміна, яка зводиться до повного перезапису файлу, представляється не як серія видалення та вставки, змішаних разом з дуже невеликою кількістю рядків, які випадково відповідають контексту, а як одне видалення всього старого, за яким слідує одна вставка всього нового, і число <m> контролює цей аспект опції
-B
(за замовчуванням 60%).-B/70%
вказує, що менше 30% оригіналу має залишитися в результаті, щоб Git вважав це повним перезаписом (тобто інакше отриманий патч буде серією видалення та вставки, змішаних разом з рядками контексту).При використанні з
-M
, повністю перезаписаний файл також вважається джерелом перейменування (зазвичай-M
розглядає лише файл, який зник, як джерело перейменування), а число <n> контролює цей аспект опції-B
(за замовчуванням 50%).-B20%
вказує, що зміна з додаванням та видаленням порівняно з 20% або більше від розміру файлу може бути розглянута як можливе джерело перейменування на інший файл. -
-M
[<n>] -
--find-renames
[=
<n>] -
Виявлення перейменувань. Якщо вказано <n>, це поріг подібності індекс (тобто кількість додавань/видалень порівняно з розмір файлу). Наприклад,
-M90%
означає, що Git повинен враховувати видалити/додати пару для перейменування, якщо більше 90% файлу не змінилося. Без знака%
число слід читати як дріб з десятковою комою перед ним. Тобто,-M5
стає 0,5, і таким чином те саме, що й-M50%
. Аналогічно,-M05
це те саме, що й-M5%
. Щоб обмежити виявлення точними перейменуваннями, використовуйте-M100%
. Індекс подібності за замовчуванням становить 50%. -
-C
[<n>] -
--find-copies
[=
<n>] -
Виявляти копії, а також перейменування. Див. також
--find-copies-harder
. Якщо вказано <n>, це має те саме значення, що й-M
<n>. -
--find-copies-harder
-
З міркувань продуктивності, за замовчуванням, опція
-C
знаходить копії, лише якщо оригінальний файл копії був змінений у тому ж наборі змін. Цей прапорець змушує команду перевіряти незмінені файли як кандидатів на джерело копії. Це дуже ресурсоємна операція для великих проектів, тому використовуйте її з обережністю. Використання кількох опцій-C
має той самий ефект. -
-D
-
--irreversible-delete
-
Пропускайте преобраз для видалення, тобто виводьте лише заголовок, але не різницю між преобразом та
/dev/null
. Отриманий патч не призначений для застосування за допомогоюpatch
абоgit
apply
; це виключно для тих, хто хоче зосередитися на перегляді тексту після зміни. Крім того, у виводі явно бракує інформації для застосування такого патчу у зворотному порядку, навіть вручну, звідси й назва опції.При використанні разом з
-B
, також пропускається прообраз у частині видалення пари видалення/створення. -
-l
<num> -
Опції
-M
та-C
передбачають деякі попередні кроки, які можуть дешево виявляти підмножини перейменувань/копій, а потім виконується вичерпна резервна частина, яка порівнює всі непарні місця призначення, що залишилися, з усіма відповідними джерелами. (Для перейменувань релевантними є лише непарні джерела, що залишилися; для копій релевантними є всі оригінальні джерела.) Для N джерел та місць призначення ця вичерпна перевірка дорівнює O(N^2). Ця опція запобігає запуску вичерпної частини виявлення перейменування/копіювання, якщо кількість вихідних/цільових файлів перевищує задану кількість. За замовчуванням використовується значенняdiff.renameLimit
. Зверніть увагу, що значення 0 вважається необмеженим. -
--diff-filter=
[(A
|C
|D
|M
|R
|T
|U
|X
|B
)...
[*
]] -
Вибирати лише файли, які додані (
A
), скопійовані (C
), видалені (D
), змінені (M
), перейменовані (R
), мають змінений тип (наприклад, звичайний файл, символічне посилання, підмодуль тощо) (T
), роз’єднані (U
), невідомі (X
) або мають розірвану пару (B
). Можна використовувати будь-яку комбінацію символів фільтра (включаючи жодного). Коли до комбінації додається*
(Все або нічого), усі шляхи вибираються, якщо в порівнянні є файл, який відповідає іншим критеріям; якщо файлів, що відповідають іншим критеріям, немає, нічого не вибирається.Також ці великі літери можна писати вниз, щоб виключити. Наприклад,
--diff-filter=ad
виключає додані та видалені шляхи.Зверніть увагу, що не всі різниці можуть відображати всі типи. Наприклад, скопійовані та перейменовані записи не можуть відображатися, якщо виявлення цих типів вимкнено.
-
-S
<string> -
Шукає відмінності, які змінюють кількість входжень зазначеного <рядка> (тобто додавання/видалення) у файлі. Призначено для використання скриптером.
Це корисно, коли ви шукаєте точний блок коду (наприклад, структуру) і хочете знати історію цього блоку з моменту його появи: використовуйте цю функцію ітеративно, щоб повернути цікавий блок у прообразі назад у
-S
, і продовжуйте, доки не отримаєте першу версію блоку.Також виконується пошук у бінарних файлах.
-
-G
<regex> -
Шукайте відмінності, текст виправлення яких містить додані/видалені рядки, що відповідають <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] для отримання додаткової інформації.
-
--find-object=
<object-id> -
Шукайте відмінності, які змінюють кількість входжень зазначеного об’єкта. Подібно до
-S
, лише аргумент відрізняється тим, що він не шукає певний рядок, а певний ідентифікатор об’єкта.Об’єкт може бути блобом або комітом підмодуля. Це передбачає використання опції
-t
уgit-log
для пошуку дерев. -
--pickaxe-all
-
Коли
-S
або-G
знаходить зміну, показати всі зміни в цьому наборі змін, а не лише файли, що містять зміну в <рядку>. -
--pickaxe-regex
-
Обробляти <рядок>, переданий
-S
, як розширений регулярний вираз POSIX для збігу. - -O<файл замовлень>
-
Контролюйте порядок, у якому файли відображаються у виводі. Це перевизначає змінну конфігурації
diff.orderFile
(див. git-config[1]). Щоб скасуватиdiff.orderFile
, використовуйте-O/dev/null
.Порядок виведення визначається порядком шаблонів глобусів у <orderfile>. Усі файли зі шляхами, що відповідають першому шаблону, виводяться першими, усі файли зі шляхами, що відповідають другому шаблону (але не першому), виводяться наступними і так далі. Усі файли зі шляхами, що не відповідають жодному шаблону, виводяться останніми, ніби в кінці файлу є неявний шаблон збігу всіх. Якщо кілька шляхів мають однаковий ранг (вони відповідають одному шаблону, але не попереднім шаблонам), їхній порядок виведення відносно один одного є звичайним порядком.
<файл_замовлення> аналізується наступним чином:
-
Пусті рядки ігноруються, тому їх можна використовувати як роздільники для зручності читання.
-
Рядки, що починаються з хеш-символа ("
#
"), ігноруються, тому їх можна використовувати для коментарів. Додайте зворотну скісну риску ("\") на початок шаблону, якщо він починається з хеш-символа. -
Кожен інший рядок містить один візерунок.
Шаблони мають той самий синтаксис і семантику, що й шаблони, що використовуються для
fnmatch
(3) без прапорцяFNM_PATHNAME
, за винятком того, що ім’я шляху також відповідає шаблону, якщо видалення будь-якої кількості компонентів кінцевого імені шляху відповідає шаблону. Наприклад, шаблон "foo*bar
" відповідає "fooasdfbar
" та "foo/bar/baz/asdf
", але не "foobarx
". -
-
--skip-to=
<файл> -
--rotate-to=
<файл> -
Видалити файли перед іменем <файл> з виводу (тобто «перейти до») або перемістити їх у кінець виводу (тобто «повернути до»). Ці опції були винайдені в основному для використання команди
git
difftool
і можуть бути не дуже корисними в іншому випадку. -
-R
-
Поміняти місцями два вхідні дані; тобто показати відмінності між індексним або дисковим файлом та вмістом дерева.
-
--relative
[=
<шлях>] -
--no-relative
-
Під час запуску з підкаталогу проєкту можна наказати програмі виключати зміни за межами каталогу та показувати шляхи відносно нього за допомогою цієї опції. Коли ви не перебуваєте в підкаталозі (наприклад, у чистому репозиторії), ви можете вказати, відносно якого підкаталогу робити вивід, вказавши <шлях> як аргумент.
--no-relative
можна використовувати для скасування як опції конфігураціїdiff.relative
, так і попереднього--relative
. -
-a
-
--text
-
Обробляти всі файли як текст.
-
--ignore-cr-at-eol
-
Ігноруйте повернення каретки в кінці рядка під час порівняння.
-
--ignore-space-at-eol
-
Ігнорувати зміни пробілів в кінці циклу.
-
-b
-
--ignore-space-change
-
Ігнорувати зміни кількості пробілів. Це ігнорує пробіли в кінці рядка та вважає всі інші послідовності з одного або кількох пробілних символів еквівалентними.
-
-w
-
--ignore-all-space
-
Ігнорувати пробіли під час порівняння рядків. Це ігнорує відмінності, навіть якщо один рядок має пробіли, а інший їх не має.
-
--ignore-blank-lines
-
Ігнорувати зміни, рядки яких порожні.
- -I<регулярний вираз>
- --ignore-matching-lines=<регулярний вираз>
-
Ігнорувати зміни, усі рядки яких відповідають <regex>. Цей параметр можна вказувати більше одного разу.
-
--inter-hunk-context=
<number> -
Показує контекст між різницями (diff hanks), до вказаної <кількості> рядків, таким чином об’єднуючи ханки, що знаходяться близько один до одного. За замовчуванням використовується значення
diff.interHunkContext
або 0, якщо параметр конфігурації не встановлено. -
-W
-
--function-context
-
Показувати всю функцію як рядки контексту для кожної зміни. Назви функцій визначаються так само, як
git
diff
визначає заголовки патч-хунк (див. "Визначення власного заголовка hunk" у gitattributes[5]). -
--exit-code
-
Зробіть так, щоб програма завершилася з кодами, подібними до
diff
(1). Тобто, вона завершується з 1, якщо були відмінності, а 0 означає відсутність відмінностей. -
--quiet
-
Вимкнути весь вивід програми. Має на увазі
--exit-code
. Вимкнути виконання зовнішніх помічників diff, код виходу яких не є довіреним, тобто їх відповідний параметр конфігураціїdiff.trustExitCode
абоdiff.
<driver>.trustExitCode
або змінна середовищаGIT_EXTERNAL_DIFF_TRUST_EXIT_CODE
має значення false. -
--ext-diff
-
Дозволити виконання зовнішнього допоміжного засобу різниці. Якщо ви встановлюєте зовнішній драйвер різниці за допомогою gitattributes[5], вам потрібно використовувати цю опцію з git-log[1] та подібними.
-
--no-ext-diff
-
Заборонити зовнішні драйвери різниці.
-
--textconv
-
--no-textconv
-
Дозволити (або заборонити) використання зовнішніх фільтрів перетворення тексту під час порівняння бінарних файлів. Див. gitattributes[5] для отримання детальної інформації. Оскільки фільтри textconv зазвичай є одностороннім перетворенням, отриманий diff придатний для використання людиною, але не може бути застосований. З цієї причини фільтри textconv увімкнено за замовчуванням лише для git-diff[1] та git-log[1], але не для git-format-patch[1] або команд diff plumbing.
-
--ignore-submodules
[=
(none
|untracked
|dirty
|all
)] -
Ігнорувати зміни в підмодулях під час генерації різниці.
all
є значенням за замовчуванням. Використанняnone
вважатиме підмодуль зміненим, якщо він містить невідстежувані або змінені файли, або йогоHEAD
відрізняється від коміту, записаного в суперпроекті, і може бути використано для перевизначення будь-яких налаштувань опціїignore
в git-config[1] або gitmodules[5]. Коли використовуєтьсяuntracked
, підмодулі не вважаються брудними, якщо вони містять лише невідстежуваний контент (але вони все одно скануються на наявність зміненого контенту). Використанняdirty
ігнорує всі зміни в робочому дереві підмодулів, відображаються лише зміни в коммітах, що зберігаються в суперпроекті (така поведінка була до версії 1.7.0). Використанняall
приховує всі зміни в підмодулях. -
--src-prefix=
<prefix> -
Показати вказане джерело <префікс> замість "a/".
-
--dst-prefix=
<prefix> -
Показувати вказаний пункт призначення <префікс> замість "b/".
-
--no-prefix
-
Не показувати жодного префікса джерела чи призначення.
-
--default-prefix
-
Використовуйте префікси джерела та призначення за замовчуванням ("a/" та "b/"). Це замінює змінні конфігурації, такі як
diff.noprefix
,diff.srcPrefix
,diff.dstPrefix
таdiff.mnemonicPrefix
(див. git-config[1]). -
--line-prefix=
<prefix> -
Додайте додатковий <префікс> до кожного рядка виводу.
-
--ita-invisible-in-index
-
За замовчуванням записи, додані за допомогою
git
add
-N
, відображаються як існуючий порожній файл уgit
diff
та як новий файл уgit
diff
--cached
. Ця опція робить запис відображатися як новий файл уgit
diff
та як неіснуючий уgit
diff
--cached
. Цю опцію можна скасувати за допомогою--ita-visible-in-index
. Обидва параметри є експериментальними та можуть бути видалені в майбутньому.
Для більш детального пояснення цих поширених опцій див. також gitdiffcore[7].
- <tree-ish>
-
Ідентифікатор об’єкта дерева.
- <path>…
-
Якщо надано, результати обмежуються підмножиною файлів, що відповідають одній із наданих специфікацій шляху.
- -r
-
Рекурсія в піддерева.
- -t
-
Показати сам запис дерева, а також його піддерева. Має на увазі -r.
- --root
-
Коли вказано
--root
, початковий коміт буде показано як велика подія створення. Це еквівалентно різниці (diff) з NULL-деревом. - --merge-base
-
Замість безпосереднього порівняння <tree-ish>, використовуйте базу злиття між двома <tree-ish> як сторону "до". Повинно бути задано два <tree-ish>, і обидва вони повинні бути комітами.
- --stdin
-
Коли вказано
--stdin
, команда не приймає аргументи типу <tree-ish> з командного рядка. Натомість вона зчитує рядки, що містять або два <tree>, один <commit>, або список <commit> зі стандартного вводу. (Використовуйте один пробіл як роздільник.)Коли задано два дерева, програма порівнює перше дерево з другим. Коли задано один коміт, програма порівнює його з його батьківськими елементами. Решта комітів, якщо їх задано, використовуються так, ніби вони є батьками першого коміта.
Під час порівняння двох дерев, ідентифікатори обох дерев (розділені пробілом і завершуються новим рядком) виводяться перед різницею. Під час порівняння комітів виводиться ідентифікатор першого (або єдиного) коміта, а потім новий рядок.
Наведені нижче прапорці додатково впливають на поведінку під час порівняння комітів (але не дерев).
- -m
-
За замовчуванням, git diff-tree --stdin не показує відмінності для комітів злиття. З цим прапорцем, він показує відмінності цього коміта від усіх його батьківських комітів. Див. також
-c
. - -s
-
За замовчуванням, git diff-tree --stdin показує відмінності або у машиночитабельному вигляді (без
-p
), або у вигляді патча (з-p
). Цей вивід можна приховати. Він корисний лише з прапорцем-v
. - -v
-
Цей прапорець змушує git diff-tree --stdin також показувати повідомлення коміту перед відмінностями.
-
--pretty
[=
<format>] -
--format=
<format> -
Вивести вміст журналів комітів у заданому форматі, де <format> може бути одним із
oneline
,short
,medium
,full
,fuller
,reference
,email
,raw
,format:
<string> таtformat:
<string>. Коли <format> не є жодним із перерахованих вище та містить%
<placeholder>, це діє так, ніби було задано--pretty=tformat:
<format>.Див. розділ «ГАРНІ ФОРМАТИ» для отримання додаткової інформації щодо кожного формату. Якщо частину
=
<формат> пропустити, за замовчуванням використовується значенняmedium
.NoteВи можете вказати стандартний гарний формат у конфігурації репозиторію (див. git-config[1]). -
--abbrev-commit
-
Замість відображення повної 40-байтової шістнадцяткової назви об’єкта коміту, відображайте префікс, який унікально називає об’єкт. Опцію
--abbrev=
<n> (яка також змінює вивід diff, якщо він відображається) можна використовувати для визначення мінімальної довжини префікса.Це має зробити
--pretty=oneline
набагато читабельнішим для людей, які використовують 80-колонкові термінали. -
--no-abbrev-commit
-
Показує повну 40-байтову шістнадцяткову назву об’єкта коміту. Це заперечує
--abbrev-commit
, явно або неявно вказано іншими опціями, такими як--oneline
. Це також перевизначає зміннуlog.abbrevCommit
. -
--oneline
-
Це скорочення від використання разом із
--pretty=oneline
--abbrev-commit
. -
--encoding=
<encoding> -
Об’єкти Commit записують кодування символів, яке використовується для повідомлення журналу, у своєму заголовку кодування; цю опцію можна використовувати, щоб вказати команді перекодувати повідомлення журналу комітів у кодуванні, яке надає перевагу користувач. Для команд, які не є фахівцями з обробки даних, за замовчуванням використовується UTF-8. Зверніть увагу, що якщо об’єкт претендує на кодування в
X
, а ми виводимо вX
, ми виводимо об’єкт дослівно; це означає, що недійсні послідовності з оригінального коміту можуть бути скопійовані на вивід. Аналогічно, якщо iconv(3) не вдається конвертувати коміт, ми непомітно виводимо оригінальний об’єкт дослівно. -
--expand-tabs=
<n> -
--expand-tabs
-
--no-expand-tabs
-
Виконайте розширення табуляції (замініть кожну табуляцію достатньою кількістю пробілів, щоб заповнити наступний стовпець відображення, кратний <n>) у повідомленні журналу перед його відображенням у виводі.
--expand-tabs
– це скорочення від--expand-tabs=8
, а--no-expand-tabs
– це скорочення від--expand-tabs=0
, що вимикає розширення табуляції.За замовчуванням вкладки розгортаються у гарних форматах, які відступають повідомлення журналу на 4 пробіли (тобто
medium
, що є значенням за замовчуванням,full
таfuller
). -
--notes
[=
<ref>] -
Показувати нотатки (див. git-notes[1]), що анотують коміт, під час відображення повідомлення журналу комітів. Це значення за замовчуванням. для команд
git
log
,git
show
таgit
whatchanged
, коли немає опцій--pretty
,--format
або--oneline
у командному рядку.За замовчуванням відображаються нотатки з посилань на нотатки, перелічених у змінних
core.notesRef
таnotes.displayRef
(або відповідних перевизначеннях середовища). Див. git-config[1] для отримання додаткової інформації.З необов’язковим аргументом <ref> використовуйте посилання (ref) для пошуку нотаток для відображення. Посилання може вказувати повну назву посилання, якщо воно починається з
refs/notes/
; якщо воно починається зnotes/
, то перед ним додаєтьсяrefs/
, а в іншому випадку повна назва посилання утворюється з префіксомrefs/notes/
.Кілька параметрів
--notes
можна комбінувати для керування відображенням нотаток. Приклади: "--notes=foo
" показуватиме лише нотатки зrefs/notes/foo
; "--notes=foo
--notes
" показуватиме як нотатки з "refs/notes/foo", так і з нотаток за замовчуванням. -
--no-notes
-
Не показувати нотатки. Це скасовує вищезгаданий параметр
--notes
, скидаючи список посилань на нотатки, з яких відображаються нотатки. Параметри обробляються в порядку, зазначеному в командному рядку, тому, наприклад, "--notes
--notes=foo
--no-notes
--notes=bar
" показуватиме лише нотатки зrefs/notes/bar
. -
--show-notes-by-default
-
Показувати нотатки за замовчуванням, якщо не задано опції відображення певних нотаток.
-
--show-notes
[=
<ref>] -
--standard-notes
-
--no-standard-notes
-
Ці опції застарілі. Натомість використовуйте наведені вище опції
--notes
/--no-notes
. -
--show-signature
-
Перевірте валідність підписаного об’єкта коміту, передавши підпис до
gpg
--verify
та покажіть результат.
- --no-commit-id
-
«git diff-tree» виводить рядок з ідентифікатором коміта, коли це можливо. Цей прапорець пригнічує вивід ідентифікатора коміта.
- -c
-
Цей прапорець змінює спосіб відображення коміту злиття (що означає, що він корисний лише тоді, коли команді задано один <tree-ish> або
--stdin
). Він показує відмінності від кожного з батьківських об’єктів до результату злиття одночасно, замість того, щоб показувати попарні різниці між батьківським об’єктом та результатом по одному (що робить опція-m
). Крім того, він відображає лише файли, які були змінені з усіх батьківських об’єктів. - --cc
-
Цей прапорець змінює спосіб відображення патча коміту злиття, подібно до опції
-c
. Він має на увазі опції-c
та-p
і додатково стискає вивід патча, пропускаючи нецікаві шматки, вміст яких у батьківських елементах має лише два варіанти, і результат злиття вибирає один з них без змін. Коли всі шматки нецікаві, сам коміт і повідомлення журналу коміту не відображаються, як і в будь-якому іншому випадку "порожньої різниці". - --combined-all-paths
-
Цей прапорець змушує об’єднані різниці (які використовуються для злиття комітів) виводити назви файлів з усіх батьківських файлів. Таким чином, він має ефект лише тоді, коли вказано -c або --cc, і, ймовірно, корисний лише тоді, коли виявлено зміни назв файлів (тобто, коли було запрошено перейменування або виявлення копіювання).
- --always
-
Показати сам коміт та повідомлення журналу комітів, навіть якщо сам список різниці порожній.
ГАРНІ ФОРМАТИ
Якщо коміт є злиттям, і якщо pretty-format не є oneline
, email
або raw
, перед рядком Author:
вставляється додатковий рядок. Цей рядок починається з "Merge:", і хеші батьківських комітів друкуються, розділені пробілами. Зверніть увагу, що перелічені коміти не обов’язково є списком "прямих" батьківських комітів, якщо ви обмежили свій перегляд історії: наприклад, якщо вас цікавлять лише зміни, пов’язані з певним каталогом або файлом.
Існує кілька вбудованих форматів, і ви можете визначити додаткові формати, встановивши параметр конфігурації pretty.<name> або на іншу назву формату, або на рядок format:
, як описано нижче (див. git-config[1]). Ось детальна інформація про вбудовані формати:
-
oneline
<hash> <title-line>
Це розроблено максимально компактно.
-
short
commit <hash> Author: <author>
<title-line>
-
medium
commit <hash> Author: <author> Date: <author-date>
<title-line>
<повідомлення про повний фіксований запис (full-commit)>
-
full
commit <hash> Author: <author> Commit: <committer>
<title-line>
<повідомлення про повний фіксований запис (full-commit)>
-
fuller
commit <hash> Author: <author> AuthorDate: <author-date> Commit: <committer> CommitDate: <committer-date>
<title-line>
<повідомлення про повний фіксований запис (full-commit)>
-
reference
<abbrev-hash> (<title-line>, <short-author-date>)
Цей формат використовується для посилання на інший коміт у повідомленні коміту та є таким самим, як
--pretty='format:%C
(auto
)%h
(%s,
%ad
). За замовчуванням дата форматується за допомогою--date=short
, якщо явно не вказано інший параметр--date
. Як і у випадку з будь-якимformat:
з заповнювачами формату, його вивід не залежить від інших параметрів, таких як--decorate
та--walk-reflogs
. -
email
Від <hash> <date> Від: <author> Дата: <author-date> Суб'єкт: [PATCH] <title-line>
<повідомлення про повний фіксований запис (full-commit)>
-
mboxrd
Як і
email
, але рядки в повідомленні коміту, що починаються з "From" (перед якими стоїть нуль або більше символів ">"), взяті в лапки ">", щоб їх не плутали з початком нового коміту. -
raw
Формат
raw
показує весь коміт точно так, як він збережений в об’єкті коміту. Примітно, що хеші відображаються повністю, незалежно від того, чи використовується--abbrev
чи--no-abbrev
, а інформація про батьків показує справжні батьківські коміти, без урахування трансплантатів або спрощення історії. Зауважте, що цей формат впливає на спосіб відображення комітів, але не на спосіб відображення різниці, наприклад, за допомогоюgit
log
--raw
. Щоб отримати повні назви об’єктів у форматі необробленої різниці, використовуйте--no-abbrev
. -
format:
<format-string>Формат
format:
<рядок-формату> дозволяє вказати, яку інформацію ви хочете відобразити. Він працює трохи подібно до формату printf, за винятком того, що замість \n ви отримуєте символ нового рядка%n
.Наприклад, «format:"Автором %h був %an, %ar%nНазва була >>%s<<%n"» виведе щось на кшталт цього:
Автором fe6e0ee був Junio C Hamano, 23 години тому Назва була >>t4119: тест автообчислення -p<n> для традиційного введення різниці.<<
Заповнювачі:
-
Заповнювачі, що розгортаються до одного літерала:
-
Заповнювачі, що впливають на форматування наступних заповнювачів:
-
%Cred
-
змінити колір на червоний
-
%Cgreen
-
змінити колір на зелений
-
%Cblue
-
змінити колір на синій
-
%Creset
-
скинути колір
-
%C
(<spec>) -
специфікація кольору, як описано в розділі "Значення" в розділі "ФАЙЛ КОНФІГУРАЦІЇ" git-config[1]. За замовчуванням кольори відображаються лише тоді, коли вони ввімкнені для виводу журналу (за допомогою
color.diff
,color.ui
або--color
, та з урахуванням налаштуваньauto
першого, якщо ми переходимо до терміналу).%C
(auto,
<spec>) приймається як історичний синонім значення за замовчуванням (наприклад,%C
(auto,red
)). Вказівка%C
(always,
<spec>) відображатиме кольори, навіть якщо колір не ввімкнено (хоча розгляньте можливість використання--color=always
, щоб увімкнути колір для всього виводу, включаючи цей формат та все інше, що git може розфарбувати).auto
сам по собі (тобто%C
(auto
)) увімкне автоматичне розфарбовування для наступних заповнювачів, доки колір знову не буде переключено. -
%m
-
лівий (<), правий (>) або граничний (
-
) знак -
%w
([<w>[,
<i1>[,
<i2>]]]) -
перемикання перенесення рядків, як-от опція
-w
у git-shortlog[1]. - %<(<n>[
,
(trunc
|ltrunc
|mtrunc
)]) -
Змусити наступний заповнювач займати щонайменше N стовпців, додаючи пробіли праворуч, якщо необхідно. За потреби, обрізати (за допомогою трикрапки
..
) ліворуч (ltrunc)..ft
, посередині (mtrunc)mi..le
або в кінці (trunc)rig..
, якщо вивід довший за <n> стовпців. Примітка 1: це обрізання працює коректно лише з <n> >= 2. Примітка 2: пробіли навколо значень <n> та <m> (див. нижче) є необов’язковими. Примітка 3: Емодзі та інші широкі символи займатимуть два стовпці відображення, що може перевищувати межі стовпців. Примітка 4: знаки поєднання розкладених символів можуть бути неправильно розміщені на межах відступів. - %<|(<m> )
-
Зробіть так, щоб наступний заповнювач займав щонайменше до <m>-го стовпця відображення, додаючи пробіли праворуч, якщо необхідно. Використовуйте від’ємні значення <m> для позицій стовпців, виміряних від правого краю вікна терміналу.
- %>(<n>)
- %>|(<m>)
-
подібно до %<(<n>), %<|(<m>) відповідно, але з пробілами зліва
- %>>(<n>)
- %>>|(<m>)
-
подібно до %>(<n>), %>|(<m>) відповідно, за винятком того, що якщо наступний заповнювач займає більше пробілів, ніж задано, і ліворуч від нього є пробіли, використовуються ці пробіли
- %><(<n>)
- %><|(<m>)
-
подібно до %<(<n>), %<|(<m>) відповідно, але з відступами з обох боків (тобто текст вирівнюється по центру)
-
-
Заповнювачі, що розширюються до інформації, отриманої з коміту:
-
%H
-
хеш коміту
-
%h
-
скорочений хеш коміту
-
%T
-
деревний хеш
-
%t
-
скорочений хеш дерева
-
%P
-
батьківські хеші
-
%p
-
скорочені батьківські хеші
-
%an
-
ім’я автора
-
%aN
-
ім’я автора (щодо .mailmap, див. git-shortlog[1] або git-blame[1])
-
%ae
-
електронна адреса автора
-
%aE
-
електронна адреса автора (щодо .mailmap, див. git-shortlog[1] або git-blame[1])
-
%al
-
локальна частина електронної пошти автора (частина перед знаком
@
) -
%aL
-
авторська локальна частина (див.
%al
) щодо .mailmap, див. git-shortlog[1] або git-blame[1]) -
%ad
-
дата автора (формат враховує опцію --date=)
-
%aD
-
дата авторства, стиль RFC2822
-
%ar
-
дата автора, відносна
-
%at
-
дата автора, позначка часу UNIX
-
%ai
-
дата авторства, формат подібний до ISO 8601
-
%aI
-
дата авторства, суворий формат ISO 8601
-
%as
-
дата автора, короткий формат (РРРР-ММ-ДД)
-
%ah
-
дата автора, людський стиль (як опція
--date=human
у git-rev-list[1]) -
%cn
-
ім’я комітера
-
%cN
-
ім’я комітера (щодо .mailmap, див. git-shortlog[1] або git-blame[1])
-
%ce
-
електронна адреса автора коміта
-
%cE
-
електронна адреса комітера (щодо .mailmap, див. git-shortlog[1] або git-blame[1])
-
%cl
-
локальна частина електронної пошти комітера (частина перед знаком
@
) -
%cL
-
локальна частина комітера (див.
%cl
) з урахуванням .mailmap, див. git-shortlog[1] або git-blame[1]) -
%cd
-
дата комітера (формат враховує опцію --date=)
-
%cD
-
дата комітера, стиль RFC2822
-
%cr
-
дата комітора, відносна
-
%ct
-
дата комітера, позначка часу UNIX
-
%ci
-
дата комітера, формат подібний до ISO 8601
-
%cI
-
дата комітера, суворий формат ISO 8601
-
%cs
-
дата створення комітора, короткий формат (РРРР-ММ-ДД)
-
%ch
-
дата комітера, людський стиль (як опція
--date=human
у git-rev-list[1]) -
%d
-
назви посилань, як-от опція --decorate для git-log[1]
-
%D
-
імена посилань без обгортання "(", ")".
-
%
(decorate
[:
<option>,...
]) -
імена посилань з власними декораціями. Рядок
decorate
може супроводжуватися двокрапкою та нулем або більше параметрами, розділеними комами. Значення параметрів можуть містити літеральні коди форматування. Їх необхідно використовувати для ком (%x2C
) та закриваючих дужок (%x29
) через їхню роль у синтаксисі параметрів.-
prefix=
<value>: Відображається перед списком імен посилань. За замовчуванням " +(+". -
suffix=
<value>: Відображається після списку імен посилань. За замовчуванням ")". -
separator=
<value>: Відображається між іменами посилань. За замовчуванням ",
". -
pointer=
<value>: Відображається між HEAD та гілкою, на яку вона вказує, якщо така є. За замовчуванням " +→+ ". -
tag=
<value>: Відображається перед назвами тегів. За замовчуванням "tag:
".
-
-
Наприклад, для створення декорацій без обтікання чи анотацій тегів, з пробілами як роздільниками:
+
%
(decorate:prefix=,suffix=,tag=,separator=
)-
%
(describe
[:
<option>,...
]) -
зрозуміла для людини назва, наприклад git-describe[1]; порожній рядок для неописуваних комітів. Після рядка
describe
може бути двокрапка та нуль або більше параметрів, розділених комами. Описи можуть бути невідповідними, якщо теги додаються або видаляються одночасно.-
tags
[=
<bool-value>]: Замість того, щоб розглядати лише анотовані теги, розгляньте також легкі теги. -
abbrev=
<number>: Замість використання стандартної кількості шістнадцяткових цифр (яка змінюватиметься залежно від кількості об’єктів у репозиторії, за замовчуванням це 7) скороченої назви об’єкта, використовуйте <кількість> цифр або стільки цифр, скільки потрібно для формування унікальної назви об’єкта. -
match=
<pattern>: Розглядати лише теги, що відповідають заданому шаблонуglob
(7
) <шаблон>, виключаючи префіксrefs/tags/
. -
exclude=
<pattern>: Не враховувати теги, що відповідають заданому шаблонуglob
(7
) <pattern>, за винятком префіксаrefs/tags/
.
-
-
%S
-
ім’я посилання, вказане в командному рядку, через яке було досягнуто коміту (наприклад,
git
log
--source
), працює лише зgit
log
-
%e
-
кодування
-
%s
-
суб’єкт
-
%f
-
очищений рядок теми, що підходить для імені файлу
-
%b
-
тіло
-
%B
-
необроблене тіло (розгорнутий об’єкт і тіло)
-
%N
-
нотатки щодо коміту
-
%GG
-
необроблене повідомлення перевірки від GPG для підписаного коміту
- %G?
-
відображати «G» для справного (дійсного) підпису, «B» для поганого підпису, «U» для справного підпису з невідомою дійсністю, «X» для справного підпису, термін дії якого минув, «Y» для справного підпису, створеного простроченим ключем, «R» для справного підпису, створеного відкликаним ключем, «E», якщо підпис неможливо перевірити (наприклад, відсутній ключ), та «N» для відсутності підпису
-
%GS
-
показати ім’я підписанта для підписаного коміту
-
%GK
-
показати ключ, який використовується для підписання підписаного коміту
-
%GF
-
показати відбиток ключа, який використовується для підписання підписаного коміту
-
%GP
-
показати відбиток первинного ключа, підрозділ якого було використано для підписання підписаного коміту
-
%GT
-
показати рівень довіри для ключа, який використовується для підписання підписаного коміту
-
%gD
-
селектор reflog, наприклад,
refs/stash@{1}
або refs/stash@{2 хвилини назад}; формат відповідає правилам, описаним для опції-g
. Частина перед@
— це ім’я посилання, як зазначено в командному рядку (томуgit
log
-g
refs/heads/master
повернеrefs/heads/master@{0}
). -
%gd
-
скорочений селектор reflog; те саме, що й
%gD
, але частина refname скорочена для зручності читання людиною (томуrefs/heads/master
стає простоmaster
). -
%gn
-
ім’я ідентифікатора reflog
-
%gN
-
ім’я ідентифікатора reflog (щодо .mailmap, див. git-shortlog[1] або git-blame[1])
-
%ge
-
електронна адреса для ідентифікації повторного журналу
-
%gE
-
електронна адреса ідентифікатора reflog (щодо .mailmap, див. git-shortlog[1] або git-blame[1])
-
%gs
-
повторно заповнити суб’єкта
-
%
(trailers
[:
<option>,...
]) -
відобразити трейлери тіла, як їх інтерпретує git-interpret-trailers[1]. Рядок
trailers
може супроводжуватися двокрапкою та нулем або більше параметрами, розділеними комами. Якщо будь-який параметр вказано кілька разів, переважає останній вхід.-
key=
<ключ>: показувати лише трейлери з вказаним <ключ>. Зіставлення виконується без урахування регістру, а двокрапка в кінці є необов’язковою. Якщо опція вказана кілька разів, відображаються рядки трейлера, що відповідають будь-якому з ключів. Ця опція автоматично вмикає опціюonly
, щоб приховувати рядки, що не є трейлерами, у блоці трейлера. Якщо це небажано, її можна вимкнути за допомогоюonly=false
. Наприклад,%
(trailers:key=Reviewed-by
) показує рядки трейлера з ключемReviewed-by
. -
only
[=
<bool>]: виберіть, чи слід включати не-трейлери рядків з трейлерного блоку. -
separator=
<sep>: вкажіть роздільник, що вставляється між рядками-завершеннями. За замовчуванням використовується символ переведення рядка. Рядок <sep> може містити літеральні коди форматування, описані вище. Щоб використовувати кому як роздільник, необхідно використовувати%x2C
, оскільки в іншому випадку він буде проаналізований як наступний параметр. Наприклад,%
(trailers:key=Ticket,separator=%x2C
) показує всі рядки-завершення, ключем яких є "Ticket", розділені комою та пробілом. -
unfold
[=
<bool>]: Змусити його поводитися так, ніби для interpret-trailer було задано опцію--unfold
. Наприклад,%
(trailers:only,unfold=true
) розгортає та показує всі рядки трейлера. -
keyonly
[=
<bool>]: покажіть лише ключову частину трейлера. -
valueonly
[=
<bool>]: покажіть лише ціннісну частину трейлера. -
key_value_separator=
<sep>: вкажіть роздільник, що вставляється між ключем і значенням кожного трейлера. За замовчуванням використовується значення ": ". В іншому випадку він має ту саму семантику, що йseparator=
<sep> вище.
-
-
Note
|
Деякі заповнювачі можуть залежати від інших опцій, наданих механізму проходження версій. Наприклад, опції %g* reflog вставлятимуть порожній рядок, якщо ми не проходимо записи reflog (наприклад, за допомогою git log -g ). Заповнювачі %d та %D використовуватимуть формат декорування "short", якщо --decorate ще не було вказано в командному рядку.
|
Логічні опції приймають необов’язкове значення [=
<логічне-значення>]. Значення, що приймаються --type=bool
git-config[1], такі як yes
та off
, також приймаються. Надання логічного параметра без =
<значення> еквівалентно наданню його з =true
.
Якщо додати знак «» (плюс) після +% заповнювача, переведення рядка вставляється безпосередньо перед розгортанням тоді і тільки тоді, коли заповнювач розгортається до непорожнього рядка.
Якщо додати знак "-" (мінус) після %
заповнювача, усі послідовні переведення рядка безпосередньо перед розгортанням видаляються тоді і тільки тоді, коли заповнювач розгортається до порожнього рядка.
Якщо додати (пробіл) після %
заповнювача, пробіл вставляється безпосередньо перед розкриттям тоді і тільки тоді, коли заповнювач розкривається до непорожнього рядка.
-
tformat:
Формат
tformat:
працює точно так само, якformat:
, за винятком того, що він надає семантику "термінатора" замість семантики "роздільника". Іншими словами, до кожного коміту додається символ завершення повідомлення (зазвичай це новий рядок), а не роздільник, розміщений між записами. Це означає, що останній запис однорядкового формату буде належним чином завершуватися новим рядком, як і у форматі "однорядковий". Наприклад:$ git log -2 --pretty=format:%h 4da45bef \ | perl -pe '$_ .= " -- NO NEWLINE\n" unless /\n/' 4da45be 7134973 -- NO NEWLINE $ git log -2 --pretty=tformat:%h 4da45bef \ | perl -pe '$_ .= " -- NO NEWLINE\n" unless /\n/' 4da45be 7134973
Крім того, будь-який нерозпізнаний рядок, що містить символ
%
, інтерпретується так, ніби перед ним стоїтьtformat:
. Наприклад, ці два еквівалентні:$ git log -2 --pretty=tformat:%h 4da45bef $ git log -2 --pretty=%h 4da45bef
Формат виводу RAW
Формат необробленого виводу з git-diff-index
, git-diff-tree
, git-diff-files
та git
diff
--raw
дуже схожий.
Ці команди порівнюють два набори речей; те, що порівнюється, відрізняється:
-
git-diff-index
<tree-ish> -
порівнює <дерево-подібне> та файли у файловій системі.
-
git-diff-index
--cached
<tree-ish> -
порівнює <деревоподібне> та індекс.
-
git-diff-tree
[-r
] <tree-ish-1> <tree-ish-2> [<pattern>...] -
порівнює дерева, названі двома аргументами.
-
git-diff-files
[<візерунок>...] -
порівнює індекс та файли у файловій системі.
Команда git-diff-tree
починає свій вивід з друку хешу порівнюваного файлу. Після цього всі команди друкують один рядок виводу для кожного зміненого файлу.
Вивідний рядок форматується таким чином:
in-place edit :100644 100644 bcd1234 0123456 M file0 copy-edit :100644 100644 abcd123 1234567 C68 file1 file2 rename-edit :100644 100644 abcd123 1234567 R86 file1 file3 create :000000 100644 0000000 1234567 A file4 delete :100644 000000 1234567 0000000 D file5 unmerged :000000 000000 0000000 0000000 U file6
Тобто, зліва направо:
-
a colon.
-
режим для "src"; 000000, якщо створення або роз’єднання.
-
a space.
-
режим для "dst"; 000000, якщо видалення або роз’єднання.
-
a space.
-
sha1 для "src"; 0{40} якщо створення або роз’єднання.
-
a space.
-
sha1 для "dst"; 0{40} якщо видалення, роз’єднання або "робоче дерево не синхронізоване з індексом".
-
a space.
-
статус, а потім необов’язкове число «оцінки».
-
символ табуляції або NUL, коли використовується опція
-z
. -
шлях для "src"
-
символ табуляції або NUL, коли використовується опція
-z
; існує лише для C або R. -
шлях для "dst"; існує лише для C або R.
-
LF або NUL, коли використовується опція
-z
, для завершення запису.
Можливі статусні літери:
-
A
: додавання файлу -
C
: копіювання файлу в новий -
D
: видалення файлу -
M
: зміна вмісту або режиму файлу -
R
: перейменування файлу -
T
: зміна типу файлу (звичайний файл, символічне посилання або підмодуль) -
U
: файл роз’єднано (ви повинні завершити об’єднання, перш ніж його можна буде зафіксувати) -
X
: тип зміни "невідомий" (скоріше за все, це помилка, будь ласка, повідомте про неї)
За літерами статусу C
та R
завжди йде оцінка (що позначає відсоток подібності між джерелом та цільовим об’єктом переміщення або копіювання). За літерою статусу M
може йти оцінка (що позначає відсоток відмінності) для перезаписів файлів.
SHA1 для "dst" відображається як суцільні нулі, якщо файл у файловій системі не синхронізований з індексом.
Приклад:
:100644 100644 5be4a4a 0000000 M file.c
Без опції -z
шляхи з "незвичайними" символами взяті в лапки, як пояснено для змінної конфігурації core.quotePath
(див. git-config[1]). При використанні -z
ім’я файлу виводиться дослівно, а рядок завершується байтом NUL.
формат diff для злиття
git-diff-tree
, git-diff-files
та git-diff
--raw
можуть приймати опцію -c
або --cc
для генерації виводу diff також для комітів злиття. Вивід відрізняється від формату, описаного вище, наступним чином:
-
для кожного з батьків є двокрапка
-
є більше режимів "src" та "src" sha1
-
статус — це об’єднані символи статусу для кожного батьківського елемента
-
немає додаткового числа "оцінка"
-
шлях(и) до файлу, розділені табуляцією
Для -c
та --cc
відображається лише кінцевий шлях, навіть якщо файл було перейменовано на будь-якому етапі історії. З --combined-all-paths
відображається назва шляху в кожному батьківському файлі, а потім назва шляху в коміті злиття.
Приклади для -c
та --cc
без --combined-all-paths
:
::100644 100644 100644 fabadb8 cc95eb0 4866510 MM desc.c ::100755 100755 100755 52b7a2d 6d1ac04 d2ac7d7 RM bar.sh ::100644 100644 100644 e07d6c5 9042e82 ee91881 RR phooey.c
Приклади, коли --combined-all-paths
додається до -c
або --cc
:
::100644 100644 100644 fabadb8 cc95eb0 4866510 MM desc.c desc.c desc.c ::100755 100755 100755 52b7a2d 6d1ac04 d2ac7d7 RM foo.sh bar.sh bar.sh ::100644 100644 100644 e07d6c5 9042e82 ee91881 RR fooey.c fuey.c phooey.c
Зверніть увагу, що «об’єднана різниця» відображає лише файли, які були змінені з усіх батьківських файлів.
Генерація тексту патча за допомогою -p
Виконання команд git-diff[1], git-log[1], git-show[1], git-diff-index[1], git-diff-tree[1] або git-diff-files[1] з опцією -p
створює текст патча. Ви можете налаштувати створення тексту патча за допомогою змінних середовища GIT_EXTERNAL_DIFF
та GIT_DIFF_OPTS
(див. git[1]), а також атрибута diff
(див. gitattributes[5]).
Те, що видається опцією -p
, дещо відрізняється від традиційного формату diff:
-
Йому передує заголовок "git diff", який виглядає так:
diff --git a/file1 b/file2
Імена файлів
a/
таb/
однакові, якщо не йдеться про перейменування/копіювання. Зокрема, навіть для створення або видалення/dev/null
не використовується замість імен файлівa/
абоb/
.Коли йдеться про перейменування/копіювання,
file1
таfile2
показують відповідно назву вихідного файлу перейменування/копіювання та назву файлу, який створюється в результаті перейменування/копіювання. -
За ним йде один або декілька розширених рядків заголовка:
старий режим <режим> новий режим <режим> видалений файл режим <режим> новий файл режим <режим> копіювати з <шлях> копіювати до <шлях> перейменувати з <шлях> перейменувати в <шлях> індекс подібності <номер> індекс несхожості <номер> індекс <хеш>..<хеш> <режим>
Режими файлів <режим> друкуються як 6-значні вісімкові числа, включаючи тип файлу та біти прав доступу до файлу.
Імена шляхів у розширених заголовках не містять префіксів
a/
таb/
.Індекс подібності – це відсоток незмінених рядків, а індекс несхожості – відсоток змінених рядків. Це округлене до меншого значення ціле число, за яким стоїть знак відсотка. Значення індексу подібності 100% таким чином зарезервовано для двох однакових файлів, тоді як несхожість 100% означає, що жоден рядок зі старого файлу не потрапив до нового.
Рядок індексу містить імена блоб-об’єктів до та після зміни. <mode> додається, якщо режим файлу не змінюється; інакше окремі рядки вказують на старий та новий режими.
-
Шляхи з «незвичайними» символами взяті в лапки, як пояснено для змінної конфігурації
core.quotePath
(див. git-config[1]). -
Усі файли
file1
у виводі посилаються на файли до коміту, а всі файлиfile2
посилаються на файли після коміту. Неправильно застосовувати кожну зміну до кожного файлу послідовно. Наприклад, цей патч поміняє місцями a та b:diff --git a/a b/b rename from a rename to b diff --git a/b b/a rename from b rename to a
-
У заголовках ханка згадується назва функції, до якої застосовується ханк. Див. "Визначення власного заголовка ханка" в gitattributes[5] для отримання детальної інформації про те, як налаштувати це для певних мов.
Комбінований формат різниці
Будь-яка команда, що генерує різниці, може використовувати опцію -c
або --cc
для створення «об’єднаної різниці» під час показу злиття. Це формат за замовчуванням під час показу злиття за допомогою git-diff[1] або git-show[1]. Також зауважте, що ви можете надати відповідну опцію --diff-merges
будь-якій із цих команд, щоб примусово генерувати різниці у певному форматі.
Формат "комбінованої різниці" виглядає так:
diff --combined describe.c index fabadb8,cc95eb0..4866510 --- a/describe.c +++ b/describe.c @@@ -98,20 -98,12 +98,20 @@@ return (a_date > b_date) ? -1 : (a_date == b_date) ? 0 : 1; } - static void describe(char *arg) -static void describe(struct commit *cmit, int last_one) ++static void describe(char *arg, int last_one) { + unsigned char sha1[20]; + struct commit *cmit; struct commit_list *list; static int initialized = 0; struct commit_name *n; + if (get_sha1(arg, sha1) < 0) + usage(describe_usage); + cmit = lookup_commit_reference(sha1); + if (!cmit) + usage(describe_usage); + if (!initialized) { initialized = 1; for_each_ref(get_name);
-
Йому передує заголовок "git diff", який виглядає ось так (коли використовується опція
-c
):diff --combined file
або ось так (коли використовується опція
--cc
):diff --cc file
-
За ним йде один або декілька розширених рядків заголовка (у цьому прикладі показано злиття з двома батьківськими об’єктами):
індекс <hash>,<hash>..<hash> режим <mode>,<mode>..<mode> новий файловий режим <mode> режим видаленого файлу <mode>,<mode>
Рядок
mode
<mode>,
<mode>..
<mode> з’являється лише тоді, коли хоча б один з <mode> відрізняється від решти. Розширені заголовки з інформацією про виявлене переміщення контенту (перейменування та виявлення копіювання) розроблені для роботи з diff двох <tree-ish> і не використовуються комбінованим форматом diff. -
Далі йде дворядковий заголовок from-file/to-file:
--- a/файл +++ б/файл
Подібно до дворядкового заголовка для традиційного «уніфікованого» формату diff,
/dev/null
використовується для сигналізації про створені або видалені файли.Однак, якщо вказано опцію --combined-all-paths, замість дворядкового заголовка from-file/to-file ви отримаєте N+1 рядковий заголовок from-file/to-file, де N — кількість батьківських об’єктів у коміті злиття:
--- a/файл --- a/файл --- a/файл +++ б/файл
Цей розширений формат може бути корисним, якщо активовано виявлення перейменування або копіювання, щоб дозволити вам бачити оригінальну назву файлу в різних батьківських об’єктах.
-
Формат заголовка фрагмента змінено, щоб запобігти випадковому передаванню його до
patch
-p1
. Комбінований формат різниці був створений для перегляду змін у комітах злиття та не призначався для застосування. Зміна подібна до зміни в розширеному заголовку index:@@@ <from-file-range> <from-file-range> <to-file-range> @@@
У заголовку фрагмента є (кількість батьківських об’єктів + 1) символи
@
для комбінованого формату різниці.
На відміну від традиційного «уніфікованого» формату порівняння, який показує два файли A та B з одним стовпцем із префіксом -
(мінус — з’являється в A, але видалений в B), +
(плюс — відсутній в A, але доданий до B) або "
"
(пробіл — без змін), цей формат порівнює два або більше файлів file1, file2,… з одним файлом X та показує, чим X відрізняється від кожного з fileN. Один стовпець для кожного з fileN додається до рядка виводу, щоб відзначити, чим рядок X відрізняється від нього.
Символ -
у стовпці N означає, що рядок з’являється у файлі N, але не з’являється в результаті. Символ +
у стовпці N означає, що рядок з’являється в результаті, а файл N не містить цього рядка (іншими словами, рядок було додано з точки зору батьківського об’єкта).
У наведеному вище прикладі виводу сигнатуру функції було змінено з обох файлів (отже, два видалення символів -
з файлу file1 та файлу file2, плюс ++
, що означає, що один доданий рядок не відображається ні у файлі file1, ні у файлі file2). Також, вісім інших рядків є такими ж з файлу file1, але не відображаються у файлі file2 (отже, з префіксом +
).
Коли відображається за допомогою git
diff-tree
-c
, він порівнює батьківські об’єкти коміту злиття з результатом злиття (тобто file1..fileN є батьками). Коли відображається за допомогою git
diff-files
-c
, він порівнює два невирішені батьківські об’єкти злиття з робочим файлом дерева (тобто file1 — це етап 2, також відомий як "наша версія", file2 — це етап 3, також відомий як "їхня версія").
інші формати різниці
Опція --summary
описує щойно додані, видалені, перейменовані та скопійовані файли. Опція --stat
додає графік diffstat
(1) до виводу. Ці опції можна комбінувати з іншими опціями, такими як -p
, і вони призначені для використання людиною.
Під час відображення зміни, що включає перейменування або копіювання, вивід --stat
форматує шляхи компактно, поєднуючи спільний префікс та суфікс шляхів. Наприклад, зміна, яка переміщує arch/i386/Makefile
на arch/x86/Makefile
під час модифікації 4 рядків, буде відображена так:
arch/{i386 => x86}/Makefile | 4 +--
Опція --numstat
надає інформацію diffstat(1), але вона розроблена для легшого використання машиною. Запис у виводі --numstat
виглядає так:
1 2 README 3 1 arch/{i386 => x86}/Makefile
Тобто з, зліва направо:
-
кількість доданих рядків;
-
вкладка;
-
кількість видалених рядків;
-
вкладка;
-
шлях (можливо, з інформацією про перейменування/копіювання);
-
новий рядок.
Коли активовано опцію виводу -z
, вивід форматується таким чином:
1 2 README NUL 3 1 NUL arch/i386/Makefile NUL arch/x86/Makefile NUL
Тобто:
-
кількість доданих рядків;
-
вкладка;
-
кількість видалених рядків;
-
вкладка;
-
NUL (існує лише якщо перейменовано/скопійовано);
-
ім’я шляху в прообразі;
-
NUL (існує лише якщо перейменовано/скопійовано);
-
шлях у postimage (існує лише якщо перейменовано/скопійовано);
-
NUL.
Додатковий NUL
перед шляхом преобразу у випадку перейменування дозволяє скриптам, які читають вивід, визначити, чи є поточний запис, що читається, записом з одним шляхом, чи записом перейменування/копіювання без попереднього читання. Після читання доданих та видалених рядків, читання до NUL
дасть ім’я шляху, але якщо це NUL
, запис покаже два шляхи.
GIT
Частина набору git[1]