freeCodeCamp/guide/russian/git/git-commit/index.md

10 KiB
Raw Blame History

title localeTitle
Git Commit Git Commit

Git Commit

Команда git commit сохранит все поэтапные изменения вместе с кратким описанием пользователя в «commit» в локальном репозитории.

Обязательства лежат в основе использования Git. Вы можете подумать о фиксации в виде моментального снимка вашего проекта, где новая версия этого проекта создается в текущем репозитории. Две важные особенности совершения:

  • вы можете вспомнить внесенные изменения позднее или вернуться к этой версии ( см. Git checkout )
  • если несколько коммитов редактируют разные части проекта, они не будут перезаписывать друг друга, даже если авторы сообщения не знали друг о друге. Это одно из преимуществ использования Git над инструментом, например Dropbox или Google Диском.

Опции

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

Опция -m

Наиболее распространенным вариантом использования git commit является опция -m . -m означает сообщение. При вызове git commit требуется включить сообщение. Сообщение должно содержать краткое описание совершенных изменений. Сообщение должно быть в конце команды, и оно должно быть заключено в котировки " " .

Пример использования опции -m :

git commit -m "My message" 

Результат в вашем терминале должен выглядеть примерно так:

[master 13vc6b2] My message 
 1 file changed, 1 insertion(+) 

ПРИМЕЧАНИЕ. Если -m не включен в команду git commit , вам будет предложено добавить сообщение в текстовый редактор по умолчанию - см. «Использование подробных сообщений коммита» ниже.

Опция -a

Другим популярным вариантом является опция -a . -a означает все. Этот параметр автоматически ставит все измененные файлы, которые должны быть зафиксированы. Если новые файлы добавлены, опция -a не будет создавать эти новые файлы. Будут зафиксированы только файлы, хранящиеся в репозитории Git.

Например:

Допустим, у вас есть файл README.md , который уже был README.md к вашему репозиторию. Если вы вносите изменения в этот файл, вы можете использовать опцию -a в своей команде commit для создания и добавления изменений в ваш репозиторий. Однако, что, если вы также добавили новый файл index.html ? Параметр -a не будет index.html поскольку он в настоящее время не существует в репозитории. Когда новые файлы были добавлены, необходимо git add команду git add для того, чтобы сгенерировать файлы, прежде чем они смогут быть привязаны к репозиторию.

Пример использования опции -a :

git commit -am “My new changes” 

Результат в вашем терминале должен выглядеть примерно так:

[master 22gc8v1] My new message 
 1 file changed, 1 insertion(+) 

Использование подробных сообщений о фиксации

Хотя git commit -m "commit message" работает просто отлично, может быть полезно предоставить более подробную и статистическую информацию.

Если вы зафиксируете без использования опции -m , git откроет текстовый редактор по умолчанию с новым файлом, который будет включать в себя список всех файлов / изменений, которые помещаются в коммит. Затем вы пишете свое подробное сообщение о фиксации (первая строка будет обрабатываться как строка темы), и фиксация будет выполняться при сохранении / закрытии файла.

Имей в виду:

  • В качестве стандартной практики держите свои строки сообщений с фиксацией менее 72 символов
  • Совершенно нормально и даже рекомендуется писать многострочные сообщения фиксации
  • Вы также можете ссылаться на другие проблемы или тянуть запросы в сообщении о фиксации. GitHub выделил номер ссылки на все запросы и проблемы с pull, поэтому, например, если вы хотите ссылаться на запрос на тяну # 788, просто сделайте это либо в строке темы, либо в основном тексте в соответствующих случаях

Опция --amend

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

git commit --amend -m "an updated commit message" 

Если вы забыли включить файл в commit:

git add FORGOTTEN-FILE-NAME 
 git commit --amend -m "an updated commit message" 
 
 # If you don't need to change the commit message, use the --no-edit option 
 git add FORGOTTEN-FILE-NAME 
 git commit --amend --no-edit 

Преждевременные совершения происходят все время в ходе вашего ежедневного развития. Легко забыть создать файл или правильно отформатировать сообщение фиксации. Флаг --amend - это удобный способ исправить эти незначительные ошибки. Эта команда заменит старое сообщение фиксации на обновленное, указанное в команде.

Исправленные коммиты - это совершенно новые коммиты, и предыдущая фиксация больше не будет в вашей текущей ветке. Когда вы работаете с другими, вы должны стараться избегать внесения изменений в коммиты, если последняя фиксация уже помещена в репозиторий.

С помощью --amend одним из полезных флагов, которые вы можете использовать, является --author который позволяет вам изменить автора последней сделанной вами фиксации. Представьте себе ситуацию, когда вы неправильно настроили свое имя или адрес электронной почты в git-конфигурациях, но вы уже совершили коммит. С флагом --author вы можете просто изменить их без сброса последнего фиксации.

git commit --amend --author="John Doe <johndoe@email.com>" 

Опция -v или --verbose

Опция -v или --verbose используется без опции -m . Опция -v может быть полезна, когда вы хотите отредактировать сообщение Git commit в редакторе по умолчанию, имея возможность видеть изменения, сделанные вами для фиксации. Команда открывает текстовый редактор по умолчанию с шаблоном сообщения фиксации, а также копию изменений, сделанных вами для этой фиксации. Изменения или diff не будут включены в сообщение фиксации, но они обеспечивают хороший способ ссылаться на ваши изменения, когда вы описываете их в своем сообщении о фиксации.

Дополнительная информация:

  • Документация Git: commit