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

НАЗВА

git-status - Показати стан робочого дерева

СИНОПСИС

git status [<options>] [--] [<pathspec>…​]

ОПИС

Відображає шляхи, що відрізняються між індексним файлом та поточним комітом HEAD, шляхи, що відрізняються між робочим деревом та індексним файлом, а також шляхи в робочому дереві, які не відстежуються Git (і не ігноруються gitignore[5]). Перші - це те, що ви б закомітили, виконавши git commit; другий і третій - це те, що ви могли б закомітити, виконавши git add перед запуском git commit.

ОПЦІЇ

-s
--short

Надайте результат у скороченому форматі.

-b
--branch

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

--show-stash

Показати кількість записів, що наразі зберігаються в сховищі.

--porcelain[=<version>]

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

Параметр <версія> використовується для визначення версії формату. Це необов’язково та за замовчуванням використовується формат оригінальної версії v1.

--long

Виведіть результат у довгому форматі. Це значення за замовчуванням.

-v
--verbose

Окрім назв файлів, які було змінено, також покажіть текстові зміни, які підготовлені для фіксації (тобто, як у виводі git diff --cached). Якщо -v вказано двічі, тоді також покажіть зміни в робочому дереві, які ще не були підготовлені (тобто, як у виводі git diff).

-u[<режим>]
--untracked-files[=<режим>]

Показати невідстежувані файли.

Параметр mode використовується для визначення обробки невідстежуваних файлів. Він необов’язковий: за замовчуванням має значення all, а якщо його вказано, то він має бути прив’язаний до опції (наприклад, -uno, але не -u no).

Можливі варіанти:

no

Не показувати невідстежувані файли.

normal

Показує невідстежувані файли та каталоги.

all

Також показувати окремі файли в невідстежуваних каталогах.

Коли опція -u не використовується, відображаються невідстежувані файли та каталоги (тобто те саме, що й при визначенні normal), щоб допомогти вам не забути додати щойно створені файли. Оскільки пошук невідстежуваних файлів у файловій системі потребує додаткової роботи, цей режим може зайняти деякий час у великому робочому дереві. Спробуйте ввімкнути невідстежуваний кеш та розділений індекс, якщо вони підтримуються (див. git update-index --untracked-cache та git update-index --split-index). В іншому випадку ви можете використовувати no, щоб git status повертав дані швидше, не показуючи невідстежувані файли. Усі звичайні варіанти написання логічного значення true сприймаються як normal, а false як no.

Значення за замовчуванням можна змінити за допомогою змінної конфігурації status.showUntrackedFiles, задокументованої в git-config[1].

--ignore-submodules[=<when>]

Ігнорувати зміни в підмодулях під час пошуку змін. <when> може мати значення none, untracked, dirty або all, що є значенням за замовчуванням.

none

вважатиме підмодуль зміненим, якщо він містить невідстежувані або змінені файли, або його HEAD відрізняється від коміта, записаного в суперпроекті, і може бути використаний для перевизначення будь-яких налаштувань опції ignore в git-config[1] або gitmodules[5].

untracked

Підмодулі не вважаються брудними, якщо вони містять лише невідстежуваний контент (але вони все одно скануються на наявність зміненого контенту).

dirty

ігнорувати всі зміни в робочому дереві підмодулів, відображаються лише зміни в коммітах, що зберігаються в суперпроекті (така поведінка була до версії 1.7.0).

all

приховує всі зміни в підмодулях (і пригнічує вивід зведених даних підмодулів, коли встановлено параметр конфігурації status.submoduleSummary).

--ignored[=<mode>]

Також показувати ігноровані файли.

Параметр mode використовується для визначення обробки ігнорованих файлів. Він необов’язковий: за замовчуванням використовується значення traditional.

Можливі варіанти:

traditional

Показувати ігноровані файли та каталоги, якщо не вказано --untracked-files=all, у такому разі відображаються окремі файли в ігнорованих каталогах.

no

Не показувати ігноровані файли.

matching

Показати ігноровані файли та каталоги, що відповідають шаблону ігнорування.

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

-z

Завершуйте записи символом NUL замість LF. Це означає вихідний формат --porcelain=v1, якщо не вказано інший формат.

--column[=<опція>]
--no-column

Відображати невідстежувані файли у стовпцях. Синтаксис опцій дивіться у змінній конфігурації column.status. --column та --no-column без опцій еквівалентні always та never відповідно.

--ahead-behind
--no-ahead-behind

Відображати або не відображати детальну кількість пропущених/відсталих етапів для гілки відносно її гілки вище за течією. За замовчуванням true.

--renames
--no-renames

Увімкнути/вимкнути виявлення перейменування незалежно від конфігурації користувача. Див. також git-diff[1] --no-renames.

--find-renames[=<n>]

Увімкнути виявлення перейменування, за бажанням встановити поріг подібності. Див. також git-diff[1] --find-renames.

<pathspec>...

Див. запис «pathspec» у gitglossary[7].

ВИХІД

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

Шляхи, згадані у виводі, на відміну від багатьох інших команд Git, створюються відносно поточного каталогу, якщо ви працюєте в підкаталозі (це зроблено навмисно, щоб полегшити копіювання та вставку). Дивіться параметр конфігурації status.relativePaths нижче.

Короткий формат

У скороченому форматі статус кожного шляху відображається в одній з цих форм

<xy> <path>
<xy> <orig-path> -> <path>

де <шлях-початку> – це походження перейменованого/скопійованого вмісту. <шлях-початку> відображається лише тоді, коли запис перейменовано або скопійовано. <xy> – це дволітерний код стану XY.

Поля (включно з ->) розділені одне від одного одним пробілом. Якщо ім’я файлу містить пробіли або інші недруковані символи, це поле буде взято в лапки як рядковий літерал C: оточене подвійними лапками ASCII (34) та з внутрішніми спеціальними символами, екранованими зворотною скісну рискою.

Існує три різні типи станів, що відображаються за допомогою цього формату, і кожен з них використовує синтаксис <xy> по-різному:

  • Коли відбувається злиття, і воно пройшло успішно, або поза межами злиття У цій ситуації X показує стан індексу, а Y показує стан робочого дерева.

  • Коли виник конфлікт злиття, який ще не вирішено, X та Y показати стан, введений кожним голівкою злиття, відносно спільного предка. Ці шляхи називаються незлитими.

  • Коли шлях не відстежується, X та Y завжди однакові, оскільки вони невідомий індексу. ?? використовується для невідстежуваних шляхів. Ігноровані файли не відображаються, якщо не використовується --ignored; якщо використовується, ігноровані файли позначаються !!.

Зверніть увагу, що термін merge тут також включає перебазування з використанням стратегії --merge за замовчуванням, вибіркові варіанти та будь-що інше, що використовує механізм злиття.

У наступній таблиці ці три класи показано в окремих розділах, а ці символи використовуються для полів X та Y для перших двох розділів, які показують відстежувані шляхи:

' '

незмінений

M

модифікований

T

тип файлу змінено (звичайний файл, символічне посилання або підмодуль)

A

додано

D

видалено

R

перейменовано

C

скопійовано (якщо для параметра конфігурації status.renames встановлено значення "копії")

U

оновлено, але не об’єднано

X Y Meaning

[AMD]

not updated

M

[ MTD]

updated in index

T

[ MTD]

type changed in index

A

[ MTD]

added to index

D

deleted from index

R

[ MTD]

renamed in index

C

[ MTD]

copied in index

[MTARC]

index and work tree matches

[ MTARC]

M

work tree changed since index

[ MTARC]

T

type changed in work tree since index

[ MTARC]

D

deleted in work tree

R

renamed in work tree

C

copied in work tree

D

D

unmerged, both deleted

A

U

unmerged, added by us

U

D

unmerged, deleted by them

U

A

unmerged, added by them

D

U

unmerged, deleted by us

A

A

unmerged, both added

U

U

unmerged, both modified

?

?

untracked

!

!

ignored

Підмодулі мають більше станів і натомість звітують

M

підмодуль має значення HEAD, відмінне від записаного в індексі

m

підмодуль має змінений вміст

?

підмодуль містить невідстежувані файли

Це пояснюється тим, що змінений контент або невідстежувані файли в підмодулі не можна додати через git add у суперпроекті для підготовки коміту.

m та ? застосовуються рекурсивно. Наприклад, якщо вкладений підмодуль у підмодулі містить невідстежуваний файл, це також повідомляється як ?.

If -b використовується, статусу короткого формату передує рядок

{empty}## <branchname> <tracking-info>

Формат порцеляни, версія 1

Формат porcelain версії 1 схожий на короткий формат, але гарантовано не змінюватиметься зворотно несумісним чином між версіями Git або залежно від конфігурації користувача. Це робить його ідеальним для парсингу скриптами. Опис короткого формату вище також описує формат porcelain, за кількома винятками:

  1. Конфігурація color.status користувача не враховується; колір завжди буде вимкнено.

  2. Конфігурація status.relativePaths користувача не враховується; показані шляхи завжди будуть відносними до кореневого каталогу репозиторію.

Також існує альтернативний формат -z, рекомендований для машинного розбору. У цьому форматі поле стану те саме, але деякі інші речі змінюються. По-перше, -> пропускається з записів перейменування, а порядок полів змінюється на протилежний (наприклад, from -> to стає to from). По-друге, після кожного імені файлу йде NUL (ASCII 0), який замінює пробіл як роздільник полів та символ нового рядка (але пробіл все ще відокремлює поле стану від першого імені файлу). По-третє, імена файлів, що містять спеціальні символи, не форматуються спеціально; лапки та екранування зворотною скісну рискою не виконуються.

Будь-які зміни підмодулів повідомляються як модифікований M замість m або одинарного ?.

Формат порцеляни, версія 2

Формат версії 2 додає детальнішу інформацію про стан робочого дерева та змінені елементи. Версія 2 також визначає розширюваний набір простих для розбору додаткових заголовків.

Заголовки починаються з символу # та додаються у відповідь на певні аргументи командного рядка. Парсери повинні ігнорувати заголовки, які вони не розпізнають.

Заголовки гілок

Якщо вказано --branch, виводиться серія рядків заголовка з інформацією про поточну гілку.

Line Notes

# branch.oid <commit> | (initial)

Current commit.

# branch.head <branch> | (detached)

Current branch.

# branch.upstream <upstream-branch>

If upstream is set.

# branch.ab +<ahead> -<behind>

If upstream is set and the commit is present.

Інформація про схованку

Якщо вказано --show-stash, виводиться один рядок, який показує кількість записів stash, якщо вони не нульові:

# запас <N>

Змінені відстежувані записи

Після заголовків друкується серія рядків для відстежуваних записів. Для опису запису може бути використаний один із трьох різних форматів рядків залежно від типу зміни. Відстежувані записи друкуються у невизначеному порядку; парсери повинні дозволяти поєднання 3 типів рядків у будь-якому порядку.

Звичайні змінені записи мають такий формат:

1 <XY> <sub> <mH> <mI> <mW> <hH> <hI> <path>

Перейменовані або скопійовані записи мають такий формат:

2 <XY> <sub> <mH> <mI> <mW> <hH> <hI> <X><score> <path><sep><origPath>
Поле Значення

<XY>

2-символьне поле, що містить проміжні та непроміжні значення XY, описані в короткому форматі, причому "." замість пробілу позначено як ".".

<sub>

4-символьне поле, що описує стан підмодуля. "N…​", якщо запис не є підмодулем. S<c><m><u>, якщо запис є підмодулем.

  • <c> є "C" якщо коміт змінився; інакше ".".

  • <m> дорівнює "M", якщо відстежуються зміни; інакше ".".

  • <u> дорівнює "U", якщо є невідстежені зміни; інакше ".".

<mH>

Вісімковий режим файлу в HEAD.

<mI>

Вісімковий режим файлу в індексі.

<mW>

Вісімковий режим файлу в робочому дереві.

<hH>

Ім’я об’єкта в HEAD.

<hI>

Ім’я об’єкта в індексі.

<X><score>

Оцінка перейменування або копіювання (що позначає відсоток подібності між джерелом та цільовим об’єктом переміщення або копіювання). Наприклад, "R100" або "C75".

<path>

Ім’я шляху. У перейменованому/скопійованому записі це цільовий шлях.

<sep>

Коли використовується параметр -z, 2 імена шляхів розділяються байтом NUL (ASCII 0x00); інакше їх розділяє TAB (ASCII 0x09).

<origPath>

Шлях у коміті в HEAD або в індексі. Це присутнє лише у перейменованому/скопійованому записі та вказує, звідки взявся перейменований/скопійований вміст.

Необ’єднані записи мають такий формат; перший символ — це «u», щоб відрізнити їх від звичайних змінених записів.

u <XY> <sub> <m1> <m2> <m3> <mW> <h1> <h2> <h3> <path>
Поле Значення

<XY>

2-символьне поле, що описує тип конфлікту як описано в короткому форматі.

<sub>

4-символьне поле, що описує стан підмодуля як описано вище.

<m1>

Вісімковий режим файлу на етапі 1.

<m2>

Вісімковий режим файлу на етапі 2.

<m3>

Вісімковий режим файлу на етапі 3.

<mW>

Вісімковий режим файлу в робочому дереві.

<h1>

Ім’я об’єкта на етапі 1.

<h2>

Ім’я об’єкта на етапі 2.

<h3>

Ім’я об’єкта на етапі 3.

<шлях>

Ім’я шляху.

Інші товари

Після відстежуваних записів (і за запитом) буде виведено серію рядків для невідстежуваних, а потім ігнорованих елементів, знайдених у робочому дереві.

Невідстежувані елементи мають такий формат:

? <path>

Ігноровані елементи мають такий формат:

! <path>

Примітки щодо формату імені шляху та -z

Коли вказано опцію -z, шляхи виводяться як є та без лапок, а рядки завершуються байтом NUL (ASCII 0x00).

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

КОНФІГУРАЦІЯ

Команда враховує змінні конфігурації color.status (або status.color — вони означають одне й те саме, і остання зберігається для зворотної сумісності) та color.status.<slot> для розфарбовування виводу.

Якщо змінна конфігурації status.relativePaths має значення false, то всі показані шляхи відносні до кореневого каталогу репозиторію, а не до поточного каталогу.

Якщо для status.submoduleSummary встановлено значення, відмінне від нуля, або значення true (ідентичне -1 або необмеженому числу), зведення підмодуля буде ввімкнено для довгого формату, а також буде показано зведення комітів для змінених підмодулів (див. опцію --summary-limit у git-submodule[1]). Зверніть увагу, що вивід зведення з команди status буде приховано для всіх підмодулів, коли diff.ignoreSubmodules встановлено на all, або лише для тих підмодулів, де submodule.<назва>.ignore=all. Щоб також переглянути зведення для ігнорованих підмодулів, ви можете скористатися опцією командного рядка --ignore-submodules=dirty або командою git submodule summary, яка показує подібний вивід, але не враховує ці налаштування.

ОНОВЛЕННЯ ФОНУ

За замовчуванням, git status автоматично оновлюватиме індекс, оновлюючи кешовану статистичну інформацію з робочого дерева та записуючи результат. Запис оновленого індексу – це оптимізація, яка не є абсолютно необхідною (status обчислює значення для себе, але їх запис призначений лише для того, щоб наступні програми не повторювали наші обчислення). Коли status виконується у фоновому режимі, блокування, що утримується під час запису, може конфліктувати з іншими одночасними процесами, що призведе до їх збою. Скрипти, що виконують status у фоновому режимі, повинні розглянути можливість використання git --no-optional-locks status (див. git[1] для отримання детальнішої інформації).

НЕВІДСЛІДЖЕНІ ФАЙЛИ ТА ПРОДУКТИВНІСТЬ

Команда git status може бути дуже повільною у великих робочих деревах, якщо/коли потрібно шукати невідстежувані файли та каталоги. Існує багато опцій конфігурації, які дозволяють пришвидшити цей процес, або уникаючи цієї роботи, або використовуючи кешовані результати попередніх команд Git. Не існує єдиного оптимального набору налаштувань, який підходить усім. Ми наведемо короткий опис відповідних опцій, щоб допомогти вам, але перш ніж переходити до списку, можливо, ви захочете запустити git status ще раз, оскільки ваша конфігурація вже може кешувати результати git status, тому наступні запуску можуть бути швидшими.

  • Прапорець --untracked-files=no або Конфігурація status.showUntrackedFiles=no (див. вище для обох): вказує, що git status не повинен повідомляти про невідстежувані файли. Це найшвидший варіант. git status не відображатиме невідстежувані файли, тому вам потрібно бути обережним, якщо ви створюєте нові файли та вручну git add їх.

  • advice.statusUoption=false (див. git-config[1]): Встановлення цієї змінної на false вимикає попередження, яке виводиться, коли перерахування невідстежуваних файлів займає більше 2 секунд. У великому проекті це може зайняти більше часу, і користувач, можливо, вже погодився на компроміс (наприклад, використання -uno може бути неприйнятним варіантом для користувача), і в такому випадку немає сенсу видавати попередження, і в такому випадку вимкнення попередження може бути найкращим варіантом.

  • core.untrackedCache=true (see git-update-index[1]): Увімкніть функцію невідстежуваного кешу та шукайте лише ті каталоги, які були змінені з моменту попередньої команди git status. Git запам’ятовує набір невідстежуваних файлів у кожному каталозі та припускає, що якщо каталог не був змінений, то набір невідстежуваних файлів у ньому не змінився. Це набагато швидше, ніж перерахування вмісту кожного каталогу, але все одно не без витрат, оскільки Git все одно має шукати набір змінених каталогів. Невідстежуваний кеш зберігається у файлі .git/index. Зменшення витрат на пошук невідстежуваних файлів дещо компенсується збільшеним розміром індексу та витратами на його оновлення. Таке скорочення часу пошуку зазвичай виправдовує додатковий розмір.

  • core.untrackedCache=true та core.fsmonitor=true або core.fsmonitor=<hook-command-pathname> (див. git-update-index[1]): увімкнути як невідстежуваний кеш, так і функції FSMonitor, і шукати лише ті каталоги, які були змінені з моменту попередньої команди git status. Це швидше, ніж використовувати лише невідстежуваний кеш, оскільки Git також може уникнути пошуку змінених каталогів. Git потрібно лише перерахувати точний набір каталогів, які нещодавно змінилися. Хоча функцію FSMonitor можна ввімкнути без невідстежуваного кешу, переваги в цьому випадку значно зменшуються.

Зверніть увагу, що після ввімкнення функцій невідстежуваного кешу та/або FSMonitor може знадобитися кілька команд git status для розігріву різних кешів, перш ніж ви побачите покращення часу виконання команд. Це нормально.

ДИВ. ТАКОЖ

gitignore[5]

GIT

Частина набору git[1]