git-status

git-status — показать состояние рабочего дерева

Показывает пути, для которых есть различия между файлом индекса и текущим коммитом HEAD, пути, для которых есть различия между рабочим деревом и файлом индекса, а также пути в рабочем дереве, не отслеживаемые Git (и не игнорируемые gitignore[5]). Первые — это то, что вы would коммит, выполнив git commit; вторые и третьи — это то, что вы could коммит, выполнив git add перед запуском git commit.

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

Пути, указанные в выводе, в отличие от многих других команд Git, становятся относительными к текущему каталогу, если вы работаете в подкаталоге (это сделано намеренно, чтобы упростить копирование и вставку). См. параметр конфигурации status.relativePaths ниже.

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

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

# stash <N>

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

2 <XY> <sub> <mH> <mI> <mW> <hH> <hI> <X><score> <path><sep><origPath>

u <XY> <sub> <m1> <m2> <m3> <mW> <h1> <h2> <h3> <path>

? <path>

! <path>

Команда учитывает настройки color.status (или status.color — они означают одно и то же, а последний вариант сохранён для обратной совместимости) и color.status.<slot>, чтобы окрашивать вывод.

Если для переменной конфигурации status.relativePaths задано значение false, все отображаемые пути будут относительными к корню репозитория, а не к текущему каталогу.

Если для status.submoduleSummary задано ненулевое число или значение true (что эквивалентно -1 или неограниченному числу), для длинного формата будет включена сводка подмодулей и будет показана сводка коммитов для изменённых подмодулей (см. параметр --summary-limit команды git-submodule[1]). Обратите внимание, что вывод сводки команды status будет подавлен для всех подмодулей, если для diff.ignoreSubmodules задано значение all, или только для тех подмодулей, для которых задано submodule.<name>.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, поэтому при последующих запусках команда может выполняться быстрее.

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

gitignore[5]