Связка локального репозитория Git с удаленным на GitHub

Как связать локальный репозиторий Git с удаленным на GitHub

Локальный репозиторий Git связывается с удалённым на GitHub командой git remote add origin с указанием URL репозитория. После этого локальные коммиты можно отправлять на сервер командой git push, а изменения с сервера загружать командой git pull.

Зачем это нужно

  • Связь локального репозитория с удалённым позволяет синхронизировать код между компьютером и облачным сервисом
  • GitHub хранит резервную копию всего проекта, защищая от потери данных при сбое локального диска
  • Удалённый репозиторий даёт возможность совместной разработки — несколько разработчиков могут работать над одним проектом
  • История всех изменений сохраняется на сервере с доступом из любого места и на любом компьютере
  • GitHub предоставляет инструменты для code review, управления задачами и автоматизации через Pull Request

Пошаговая инструкция

  1. Перейдите на сайт github.com и авторизуйтесь в своём аккаунте
  2. Нажмите на иконку профиля в верхнем правом углу и выберите Your repositories
  3. Нажмите кнопку New для создания нового репозитория
  4. Введите имя репозитория в поле Repository name (например, my-project)
  5. Выберите видимость репозитория — Public (открытый для всех) или Private (только для вас и приглашённых)
  6. НЕ отмечайте галочку Initialize this repository with a README, так как у вас уже есть локальный репозиторий
  7. Нажмите кнопку Create repository
  8. На странице нового репозитория скопируйте URL в формате https://github.com/ваш-логин/имя-репозитория.git (находится в зелёной кнопке Code)
  9. Откройте терминал и перейдите в директорию вашего локального проекта командой cd путь/к/проекту
  10. Проверьте, что репозиторий инициализирован, командой git status
  11. Добавьте удалённый репозиторий командой git remote add origin скопированный-URL
  12. Замените скопированный-URL на URL из пункта 8 (например, git remote add origin https://github.com/vasya/my-project.git)
  13. Проверьте, что удалённый репозиторий добавлен, командой git remote -v — должны отобразиться две строки с URL
  14. Если у вас есть коммиты в локальном репозитории, переименуйте основную ветку на main командой git branch -M main
  15. Отправьте локальные коммиты на GitHub командой git push -u origin main
  16. При первой отправке GitHub может запросить аутентификацию — используйте личный токен доступа или SSH-ключ вместо пароля
  17. После завершения отправки перейдите на страницу репозитория на GitHub и убедитесь, что ваши файлы и коммиты загрузились

Часто задаваемые вопросы

Как изменить URL удалённого репозитория, если он был добавлен неправильно? Выполните команду git remote set-url origin новый-URL, где новый-URL — правильный адрес репозитория на GitHub.

Что делать, если при push выпадает ошибка об аутентификации? Создайте личный токен доступа в настройках GitHub (Developer settings → Personal access tokens) и используйте его вместо пароля при запросе.

Можно ли связать локальный репозиторий с удалённым, если там уже есть файлы? Да, но сначала выполните git pull origin main --allow-unrelated-histories, чтобы загрузить удалённые файлы и объединить истории.

Похожие материалы

Первый коммит в Git команды add и commit подробно
Локальный репозиторий Git через консоль команды init
Полезные расширения для VS Code упрощающих написание кода