git add

Описание

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

Принципы работы

Команды git add и git commit используются для записи версий проекта в историю репозитория. Они необходимы каждому пользователю Git, поскольку составляют основу рабочего процесса Git.

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

Область подготовки

Основная роль команды git add — переносить изменения из рабочего каталога в область подготовки Git. Область подготовки Git — одна из его самых особенных характеристик, которая позволяет собирать все связанные изменения в очень точные снимки состояния. Только после этого вы можете зафиксировать эти изменения в истории проекта.

Часто используемые параметры

1. Подготовка изменений в <file> для следующего коммита:

git add file

git add <file>

2. Подготовка всех изменений в <directory> для следующего коммита:

git add directory

git add <directory>

3. Подготовка всех изменений в уже отслеживаемых файлах:

git add -u

git add -u

4. Интерактивный режим patch (подготовка изменений по отдельным фрагментам):

git add -p

git add -p

Примеры использования git add

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

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

Добавить файл

git add hello.py

Зафиксировать изменения

git commit

Интерактивный режим

Интерактивная сессия подготовки позволяет выбрать части файла, которые будут добавлены в следующий коммит. Вам будет показан фрагмент изменений и предложена команда. Доступные варианты:

• y - подготовить фрагмент
• n - не подготавливать фрагмент
• q - выйти; не подготавливать фрагмент и все оставшиеся
• a - подготовить фрагмент и все последующие фрагменты в файле
• d - не подготавливать фрагмент и все последующие фрагменты в файле
• g - выбрать фрагмент для перехода
• / - искать фрагмент, соответствующий заданному регулярному выражению
• j - перейти к следующему фрагменту
• J - перейти к предыдущему фрагменту
• k - перейти к предыдущему фрагменту
• K - перейти к предыдущему невыбранному фрагменту
• s - разделить текущий фрагмент на более мелкие
• e - вручную отредактировать текущий фрагмент
• ? - вывести справку

Редактирование патчей

Вызов git add -e или выбор e в интерактивном селекторе фрагментов открывает патч в вашем редакторе. После выхода из редактора результат применяется к индексу. Вы можете вносить в патч любые изменения, но некоторые правки могут привести к сложному выводу или даже сделать патч неприменимым. Если вы хотите полностью отказаться от операции, просто удалите все строки патча. Ниже приведены некоторые распространённые элементы, которые можно увидеть в патче, и какие операции редактирования для них имеют смысл.

Строки, начинающиеся с +, обозначают добавленное содержимое. Вы можете удалить их, чтобы не подготавливать любые добавленные строки.

Строки, начинающиеся с -, обозначают удалённое содержимое. Чтобы не подготавливать их удаление, можно заменить - на пробел ().

Изменённое содержимое показывается строками - (удаление старого содержимого), за которыми следуют строки + (добавление заменяющего содержимого). Чтобы не подготавливать изменение, замените строки - на пробелы и удалите строки +. Обратите внимание, что изменение только одной половины пары может привести к запутанным изменениям в индексе.

Практика

What are the functionalities and options associated with the 'git add' command?

'git add' is used to add changes in the working directory to the staging area.The command is used to commit changes directly to the repository.'git add <file>' stages changes in a specific file for the next commit.'git add -u' stages all changes in already tracked files.Interactive mode in 'git add' allows selecting specific parts of a file to stage.Using 'git add -e' opens a patch in the editor for detailed editing before staging.