Команда git push отправляет локальные коммиты в удаленный репозиторий, например на GitHub или GitLab. Для отправки ветки main в репозиторий origin выполните git push origin main.
Что делает команда git push
Команда git push передает коммиты и обновляет ветки или теги в удаленном репозитории. Несохраненные в коммите изменения файлов команда не отправляет.
Команды выполняйте в терминале из папки локального репозитория. Если репозиторий находится на облачном сервере, сначала подключитесь к нему по протоколу SSH.
В примерах используется ветка main. Если в проекте другое имя основной ветки, укажите его в командах. Переименовывать ветку для отправки не нужно.
Как подготовиться к отправке
-
1
Проверьте текущую ветку и состояние файлов:
git status git branch --show-current -
2
Если изменения еще не сохранены в коммите, добавьте нужные файлы и создайте коммит:
git add README.md git commit -m "Update README"Где README.md — имя измененного файла. Если файлов несколько, укажите их через пробел. Перед коммитом проверьте, что среди них нет паролей и токенов.
-
3
Проверьте адрес удаленного репозитория:
git remote -vЕсли
originуже указан и адрес верный, переходите к отправке. Послеgit cloneрепозиторийoriginобычно настроен автоматически. -
4
Если удаленный репозиторий еще не добавлен, скопируйте его адрес для протокола HTTPS из GitHub или GitLab и добавьте:
git remote add origin https://github.com/UserLogin/test-reg.gitГде https://github.com/UserLogin/test-reg.git — адрес репозитория. У вашей учетной записи должны быть права на отправку изменений.
-
5
Для исправления существующего адреса используйте:
git remote set-url origin https://github.com/UserLogin/test-reg.git
Базовый синтаксис и частые флаги
git push origin main
Где:
origin — имя удаленного репозитория в локальной конфигурации Git;
main — локальная ветка, которую нужно отправить в одноименную удаленную ветку.
Перед отправкой можно проверить, какие ветки Git собирается обновить:
git push --dry-run origin main
Флаг --dry-run выполняет предварительную проверку без обновления удаленных веток.
Первая отправка ветки: —u и —set-upstream
Для первой отправки ветки main настройте связь с удаленной веткой:
git push -u origin main
Флаг -u, или --set-upstream, задает отслеживаемую удаленную ветку. После успешной отправки при стандартных настройках Git для следующих отправок из main достаточно команды:
git push
Посмотреть локальные коммиты, которых нет в отслеживаемой ветке, можно после обновления сведений с сервера:
git fetch origin
git log --oneline origin/main..main
Команда покажет коммиты локальной ветки main, которых нет в origin/main — локальной ссылке на состояние удаленной ветки после git fetch.
Отправка всех веток: —all
Чтобы отправить все локальные ветки, выполните:
git push --all origin
Команда не отправляет теги и не создает локальные ветки из удаленных. Перед запуском проверьте список веток командой git branch.
Отправка тегов: —tags
Для отправки существующего тега выполните:
git push origin tag v1.0.0
Где v1.0.0 — имя локального тега. Список тегов показывает команда git tag.
Для отправки всех локальных тегов используйте:
git push --tags origin
Обычная отправка ветки не отправляет все теги автоматически.
Принудительная отправка: —force и —force-with-lease
Принудительная отправка нужна после намеренного изменения уже опубликованной истории, например после выполнения git rebase.
Внимание
Флаг --force может убрать чужие коммиты из истории удаленной ветки. Не используйте его для исправления обычного отказа при отправке.
Если переписывание истории согласовано с командой, используйте --force-with-lease:
git push --force-with-lease origin main
Git отклонит отправку, если удаленная ветка отличается от ожидаемого состояния. Без дополнительных параметров ожидание берется из локальной ссылки origin/main.
Фоновый git fetch в редакторе может обновить origin/main и ослабить эту проверку. Флаг --force-with-lease не заменяет проверку истории и согласование с коллегами. Защищенная ветка может запрещать принудительную отправку.
Как удалить удаленную ветку через git push
Убедитесь, что ветка больше не нужна и ее изменения сохранены. Затем выполните:
git push origin --delete feature-test
Вместо feature-test укажите имя удаленной ветки. Локальная ветка останется. Основную или защищенную ветку сервер может не разрешить удалить.
Частые ошибки git push и их решение
Сообщение error: failed to push some refs означает, что Git не отправил часть ссылок. Причину смотрите в строках выше: это может быть расхождение истории, ошибка доступа или правило защиты ветки.
Ошибка non-fast-forward: rejected или fetch first
В удаленной ветке есть коммиты, которых нет в локальной истории. Получите их и объедините со своими изменениями.
-
1
Сохраните незавершенные изменения в коммите или временно отложите их. Затем переключитесь на ветку
mainи проверьте состояние файлов:git switch main git status -
2
Загрузите изменения и выполните слияние:
git fetch origin git merge origin/main -
3
Если возникли конфликты, исправьте отмеченные файлы. Добавьте исправления и завершите слияние:
git add README.md git merge --continueВместо README.md укажите через пробел все файлы, в которых вы исправили конфликты. Если конфликтов нет, этот шаг пропустите.
-
4
Проверьте результат слияния и повторите отправку:
git push origin mainЕсли Git сообщает о несвязанных историях, не добавляйте
--force. Проверьте адрес репозитория: локальный и удаленный проекты могли быть созданы независимо.
Ошибка аутентификации: Support for password authentication was removed
GitHub не принимает пароль учетной записи для операций Git по протоколу HTTPS. Используйте персональный токен доступа (Personal Access Token, PAT), менеджер учетных данных или SSH-ключ.
-
1
Проверьте способ подключения:
git remote -v -
2
Для подключения по протоколу HTTPS создайте токен по инструкции GitHub. Разрешите доступ к нужному репозиторию и запись содержимого. При запросе имени введите логин GitHub, а вместо пароля вставьте токен.
-
3
Если Git продолжает использовать старый пароль, удалите сохраненную запись GitHub из используемого менеджера учетных данных и повторите отправку.
В GitLab токен также можно использовать вместо пароля. При включенной двухфакторной аутентификации он обязателен для этого способа входа. Для отправки через персональный токен GitLab требуется право write_repository или другое право, включающее запись в репозиторий.
Не добавляйте токен в адрес репозитория или команды: он может сохраниться в истории терминала и конфигурации Git.
Для подключения по протоколу SSH добавьте открытый ключ в учетную запись GitHub или GitLab. Затем замените адрес origin на SSH-адрес из настроек репозитория:
git remote set-url origin git@github.com:UserLogin/test-reg.git
git push origin main
Где git@github.com:UserLogin/test-reg.git — SSH-адрес репозитория. Если появляется Permission denied (publickey), проверьте, что используется ключ, открытая часть которого добавлена в нужную учетную запись.
Отправка в защищенную ветку запрещена
Если сервер сообщает protected branch или pre-receive hook declined, прочитайте полный ответ сервера. Если отправка в защищенную ветку запрещена, отправьте изменения в отдельную ветку и создайте запрос на слияние. Другие причины отказа могут быть связаны с размером файлов, проверкой секретов или правилами проекта.
Частые вопросы
Как отправить новую локальную ветку на сервер?
Если в ветке есть незакоммиченные изменения, которые нужно отправить, сначала создайте коммит. Чтобы опубликовать ветку, выполните:
git push -u origin feature-test
Вместо feature-test укажите имя локальной ветки. Git создаст одноименную удаленную ветку, если у вас есть права.
Как удалить удаленную ветку?
git push origin --delete feature-test. Команда удалит только удаленную ветку feature-test. Подробности приведены в разделе об удалении веток.
Что делать при ошибке «failed to push some refs»?
non-fast-forward получите удаленные изменения и объедините их с локальными. При ошибке аутентификации проверьте токен или SSH-ключ. Принудительная отправка не исправляет ошибки доступа.
Почему Git сообщает «Everything up-to-date»?
git status: возможно, изменения еще не включены в коммит или выбрана другая ветка.
Была ли статья полезна?
Спасибо за оценку. Рады помочь 😊