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

НАЗВА

git-add — Додавання вмісту файлу до індексу

СИНОПСИС

git add [--verbose | -v] [--dry-run | -n] [--force | -f] [--interactive | -i] [--patch | -p]
	[--edit | -e] [--[no-]all | -A | --[no-]ignore-removal | [--update | -u]] [--sparse]
	[--intent-to-add | -N] [--refresh] [--ignore-errors] [--ignore-missing] [--renormalize]
	[--chmod=(+|-)x] [--pathspec-from-file=<файл> [--pathspec-file-nul]]
	[--] [<специфікація шляху>…​]

ОПИС

Додавання вмісту нових або змінених файлів до індексу. «Індекс» (також відомий як «область проміжної обробки [staging area]») — це те, що ви використовуєте для підготовки вмісту наступного коміту.

Коли ви запускаєте git commit без будь-яких інших аргументів, будуть зафіксовані лише зміни додані до stage. Наприклад, якщо ви відредагували file.c і хочете зафіксувати свої зміни до цього файлу, ви можете скористатись командами:

git add file.c
git commit

Ви також можете додати лише частину змін до файлу за допомогою git add -p.

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

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

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

Будь ласка, дивіться git-commit[1] для альтернативних способів додавання контенту до коміту.

ОПЦІЇ

<pathspec>...

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

Для отримання додаткової інформації про синтаксис <специфікатора-шляху> див. елемент pathspec у gitglossary[7].

-n
--dry-run

Насправді не додає файл(и), лише показує, чи вони існують та/або будуть проігноровані.

-v
--verbose

Докладний вивід.

-f
--force

Дозволяє додавання файлів, які зазвичай ігноруються. Ця опція також використовується, коли встановлено submodule.<name>.ignore=all, але ви хочете додати оновлення субмодуля в stage. Шлях до субмодуля (path) необхідно вказати явно.

--sparse

Дозволяє оновлення елементів індексу поза межами конуса розрідженого контролю. Зазвичай, git add відмовляється оновлювати елементи індексу, шляхи яких не вписуються в конус розрідженого контролю, оскільки ці файли можуть бути видалені з робочого дерева без попередження. Див. git-sparse-checkout[1] для отримання додаткової інформації.

-i
--interactive

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

-p