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

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

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

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

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

Если переменная конфигурации 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 автоматически обновляет индекс, обновляя кэшированную информацию stat из рабочего каталога и записывая результат. Запись обновлённого индекса является оптимизацией, которая не является строго необходимой (status вычисляет значения для себя, но их запись предназначена только для того, чтобы избавить последующие программы от повторения наших вычислений). Когда status запускается в фоновом режиме, блокировка, удерживаемая во время записи, может конфликтовать с другими параллельными процессами, вызывая их сбой. Сценариям, запускающим status в фоновом режиме, следует рассмотреть возможность использования git --no-optional-locks status (подробности см. в git[1]).

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

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

gitignore[5]

Является частью пакета git[1]