git-add

Файлы, содержимое которых нужно добавить. Для добавления всех подходящих файлов можно использовать шаблоны файлов (например, *.c). Также можно указать имя каталога в начале (например, dir, чтобы добавить dir/file1 и dir/file2), чтобы обновить индекс в соответствии с текущим состоянием каталога целиком (например, указание dir зафиксирует не только изменённый в рабочем дереве файл dir/file1 и добавленный в рабочее дерево файл dir/file2, но и удалённый из рабочего дерева файл dir/file3). Обратите внимание, что в старых версиях Git удалённые файлы игнорировались; используйте параметр --no-all, если хотите добавить изменённые или новые файлы, но игнорировать удалённые.

Подробнее о синтаксисе <pathspec> см. в разделе pathspec справочника gitglossary[7].

Не добавлять файлы, а только показывать, существуют ли они и/или будут ли проигнорированы.

Выводить подробную информацию.

Разрешить добавление файлов, которые в противном случае были бы проигнорированы. Этот параметр также используется, если задано submodule.<name>.ignore=all, но вы хотите подготовить обновление подмодуля. Изменение path подмодуля необходимо указать явно.

Разрешить обновление записей индекса за пределами конуса разреженного извлечения. Обычно git add отказывается обновлять записи индекса, пути которых не входят в конус разреженного извлечения, поскольку эти файлы могут быть удалены из рабочего дерева без предупреждения. Подробнее см. в git-sparse-checkout[1].

В интерактивном режиме добавлять изменённое содержимое рабочего дерева в индекс. Чтобы ограничить операцию частью рабочего дерева, можно указать необязательные аргументы-пути. Подробнее см. в разделе «Интерактивный режим».

В интерактивном режиме выбирать фрагменты исправления между индексом и рабочим деревом и добавлять их в индекс. Это позволяет просмотреть различия перед добавлением изменённого содержимого в индекс.

Фактически выполняется add --interactive, но пропускается начальное меню команд и сразу запускается подкоманда patch. Подробнее см. в разделе «Интерактивный режим».

Создавать различия с <n> строками контекста. По умолчанию количество строк контекста равно diff.context или 3, если переменная конфигурации не задана. (Из-за исторической особенности -U без <n> молча принимается как синоним -p.)

Показывать контекст между фрагментами различий, не превышающий указанное <number> строк, объединяя близко расположенные фрагменты. По умолчанию значение равно diff.interHunkContext или 0, если параметр конфигурации не задан.

Открыть различия с индексом в редакторе и разрешить пользователю изменить их. После закрытия редактора скорректировать заголовки фрагментов и применить исправление к индексу.

Этот параметр предназначен для выбора строк исправления, которые нужно применить, или даже для изменения содержимого подготавливаемых строк. Это может быть быстрее и гибче, чем интерактивный выбор фрагментов. Однако легко запутаться и создать исправление, которое нельзя применить к индексу. См. раздел «РЕДАКТИРОВАНИЕ ИСПРАВЛЕНИЙ» ниже.

Обновлять индекс только там, где уже есть запись, соответствующая <pathspec>. Удалять и изменять записи индекса в соответствии с рабочим деревом, но не добавлять новые файлы.

Если при использовании параметра -u не задан <pathspec>, обновляются все отслеживаемые файлы во всём рабочем дереве (в старых версиях Git обновление ограничивалось текущим каталогом и его подкаталогами).

Обновлять индекс не только там, где в рабочем дереве есть файл, соответствующий <pathspec>, но и там, где в индексе уже имеется запись. Добавлять, изменять и удалять записи индекса в соответствии с рабочим деревом.

Если при использовании параметра -A не задан <pathspec>, обновляются все файлы во всём рабочем дереве (в старых версиях Git обновление ограничивалось текущим каталогом и его подкаталогами).

Обновлять индекс, добавляя новые файлы, отсутствующие в индексе, и файлы, изменённые в рабочем дереве, но игнорировать файлы, удалённые из рабочего дерева. Если <pathspec> не указан, этот параметр ничего не делает.

Этот параметр предназначен главным образом для пользователей, привыкших к старым версиям Git, где git add <pathspec>... был синонимом git add --no-all <pathspec>..., то есть игнорировал удалённые файлы.

Зафиксировать только факт того, что путь будет добавлен позже. В индекс помещается запись пути без содержимого. Это полезно, помимо прочего, чтобы показывать неподготовленное содержимое таких файлов с помощью git diff и включать их в коммит с помощью git commit -a.

Не добавлять файлы, а только обновить сведения stat() о них в индексе.

Если некоторые файлы не удалось добавить из-за ошибок при их индексировании, не прерывать операцию, а продолжить добавление остальных. Команда всё равно должна завершиться с ненулевым кодом возврата. Чтобы сделать это поведением по умолчанию, переменной конфигурации add.ignoreErrors можно присвоить значение true.

Этот параметр можно использовать только вместе с --dry-run. С его помощью можно проверить, будут ли проигнорированы какие-либо из указанных файлов, независимо от того, присутствуют ли они уже в рабочем дереве.

По умолчанию git add предупреждает при добавлении встроенного репозитория в индекс без использования git submodule add для создания записи в .gitmodules. Этот параметр отключает предупреждение (например, если вы вручную выполняете операции с подмодулями).

Заново применить процесс «clean» ко всем отслеживаемым файлам, чтобы принудительно добавить их в индекс. Это полезно после изменения конфигурации core.autocrlf или атрибута text, чтобы исправить файлы, добавленные с неправильными окончаниями строк CRLF/LF. Этот параметр подразумевает -u. Одиночные символы CR не изменяются: поэтому, хотя CRLF преобразуется в LF, последовательность CRCRLF очищается лишь частично — до CRLF.

Переопределить бит исполнения у добавляемых файлов. Бит исполнения изменяется только в индексе; файлы на диске остаются без изменений.

Передавать pathspec в <file> вместо аргументов командной строки. Если <file> — это в точности -, используется стандартный ввод. Элементы pathspec разделяются символами LF или CR/LF. Элементы pathspec можно заключать в кавычки, как описано для переменной конфигурации core.quotePath (см. git-config[1]). См. также --pathspec-file-nul и глобальный параметр --literal-pathspecs.

Имеет смысл только вместе с --pathspec-from-file. Элементы pathspec разделяются символом NUL, а все остальные символы воспринимаются буквально (включая символы новой строки и кавычки).

Этот параметр можно использовать, чтобы отделить параметры командной строки от списка файлов (полезно, если имена файлов могут быть ошибочно приняты за параметры командной строки).

Для каждого пути показывает изменения между HEAD и индексом (то есть то, что будет включено в коммит при вводе git commit), а также между индексом и файлами рабочего дерева (то есть то, что ещё можно подготовить перед выполнением git commit с помощью git add). Пример вывода:

              staged     unstaged path
     1:       binary      nothing foo.png
     2:     +403/-35        +1/-1 add-interactive.c

Вывод показывает, что файл foo.png отличается от HEAD (но это двоичный файл, поэтому количество строк показать нельзя), а между копией в индексе и версией в рабочем дереве различий нет (если бы версия в рабочем дереве также отличалась, вместо nothing отображалось бы binary). В другом файле, add-interactive.c, 403 строки добавлены и 35 удалены в версии из индекса, которая будет включена в коммит, но в файле рабочего дерева есть дополнительные изменения (одна строка добавлена и одна удалена).

Показывает сведения о состоянии и приглашение «Update>>». Если приглашение заканчивается двумя символами >>, можно выбрать несколько пунктов, разделив их пробелом или запятой. Также можно указать диапазоны. Например, «2-5 7,9» выберет из списка пункты 2, 3, 4, 5, 7 и 9. Если второе число диапазона не указано, выбираются все оставшиеся исправления. Например, «7-» выберет из списка пункты 7, 8 и 9. Введите *, чтобы выбрать всё.

Выбранные пункты будут выделены *, например:

           staged     unstaged path
  1:       binary      nothing foo.png
* 2:     +403/-35        +1/-1 add-interactive.c

Чтобы отменить выбор, поставьте в начале ввода -, например:

Update>> -2

После выбора нажмите клавишу ввода на пустой строке, чтобы подготовить в индексе содержимое файлов рабочего дерева для выбранных путей.

Интерфейс этой подкоманды очень похож на интерфейс update, а подготовленные изменения для выбранных путей отменяются до состояния версии HEAD. Отмена для новых путей делает их неотслеживаемыми.

Интерфейс этой подкоманды очень похож на интерфейсы update и revert; она позволяет добавлять неотслеживаемые пути в индекс.

Позволяет выбрать один путь из списка вида status. После выбора пути показываются различия между индексом и файлом рабочего дерева, и для каждого фрагмента предлагается решить, нужно ли подготовить изменение. Можно выбрать один из следующих вариантов и нажать клавишу ввода:

y - stage this hunk
n - do not stage this hunk
q - quit; do not stage this hunk or any of the remaining ones
a - stage this hunk and all later hunks in the file
d - do not stage this hunk or any of the later hunks in the file
g - select a hunk to go to
/ - search for a hunk matching the given regex
j - go to the next undecided hunk, roll over at the bottom
J - go to the next hunk, roll over at the bottom
k - go to the previous undecided hunk, roll over at the top
K - go to the previous hunk, roll over at the top
s - split the current hunk into smaller hunks
e - manually edit the current hunk
p - print the current hunk
P - print the current hunk using the pager
? - print help

После выбора действия для всех фрагментов, если был выбран хотя бы один фрагмент, индекс обновляется с учётом выбранных фрагментов.

Чтобы не нажимать клавишу ввода в этом месте, можно присвоить переменной конфигурации interactive.singleKey значение true.

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

Указывает команде git add продолжать добавлять файлы, если некоторые из них не удаётся добавить из-за ошибок индексирования. Эквивалент параметра --ignore-errors. Параметр add.ignore-errors считается устаревшим, поскольку не соответствует обычному соглашению об именовании переменных конфигурации.