Команда git pull, выполненная в папке локального репозитория, — это основной способ обновить репозиторий GitHub на компьютере: она скачивает свежие коммиты с удалённого сервера и сливает их с вашей текущей веткой. Если после её запуска терминал отвечает ошибкой вроде error: Your local changes would be overwritten by merge или fatal: refusing to merge unrelated histories, значит, локальная копия разошлась с серверной, и перед обновлением нужно разобраться с состоянием рабочей директории.
В этой статье разберём все рабочие сценарии: обычное обновление через git pull, безопасную проверку изменений через git fetch, принудительную синхронизацию, когда локальные правки не нужны, а также решение типичных конфликтов. Инструкции подходят для Windows, macOS и Linux — команды Git одинаковы во всех системах, отличается только способ открытия терминала.
Проверка текущего состояния репозитория
Перед любыми действиями полезно понять, в каком состоянии находится локальная копия. Для этого откройте терминал в папке репозитория: в Windows это можно сделать через контекстное меню папки — пункт «Открыть в терминале» или Git Bash Here, если установлен Git for Windows. На macOS и Linux достаточно перейти в каталог командой cd.
Выполните команду git status. Она покажет, есть ли незакоммиченные изменения, на какой ветке вы находитесь и насколько она отстала или опередила удалённую. Именно этот вывод определяет, какой сценарий обновления выбрать дальше.
git status
git branch --show-current
Вторая команда выводит имя текущей ветки — обновлять нужно именно ту ветку, с которой вы работаете, чаще всего это main или master.
Стандартное обновление через git pull
Если git status показывает чистое рабочее дерево (nothing to commit, working tree clean), обновление сводится к одной команде. Вам нужно выполнить git pull с указанием удалённого репозитория и ветки:
git pull origin mainЗдесь origin — стандартное имя удалённого репозитория, а main — ветка. Если ваша основная ветка называется master, подставьте её имя. Когда ветка уже «отслеживает» удалённую, достаточно просто git pull без аргументов.
После выполнения Git выведет список изменённых файлов и статистику: сколько строк добавлено и удалено. Если в ответ пришло Already up to date — локальная копия уже актуальна, обновлять нечего.
☑️ Порядок обновления репозитория
Разница между git fetch и git pull
Многие путают эти две команды, хотя разница между ними принципиальна. git fetch только скачивает данные с GitHub, но не трогает ваши файлы — вы можете спокойно посмотреть, что изменилось, и решить, принимать ли обновления. git pull — это фактически связка git fetch + git merge: изменения сразу вливаются в рабочую копию.
Осторожный сценарий выглядит так:
git fetch origin
git log HEAD..origin/main --oneline
git merge origin/main
Вторая команда показывает список коммитов, которые появились на сервере, но ещё отсутствуют у вас. Такой подход удобен, когда над чужим кодом работали другие люди и нужно понять масштаб изменений до слияния.
| Команда | Что делает | Меняет ли ваши файлы |
|---|---|---|
git fetch | Скачивает коммиты с сервера | Нет |
git pull | Скачивает и сливает изменения | Да |
git pull --rebase | Скачивает и переносит ваши коммиты поверх | Да |
git reset --hard | Приводит копию к состоянию сервера | Да, удаляет локальные правки |
Обновление при наличии локальных изменений
Самая частая проблема: вы правили файлы локально, а на GitHub тем временем появились новые коммиты. Прямой git pull в этом случае либо откажется работать, либо создаст конфликт слияния. Есть несколько безопасных путей.
- 💾 Закоммитить изменения:
git add .иgit commit -m "описание", затемgit pull— Git попытается слить обе версии. - 📦 Спрятать правки в stash:
git stashубирает изменения «в карман», послеgit pullверните их командойgit stash pop. - 🌿 Создать отдельную ветку:
git checkout -b my-changesсохранит правки изолированно от основной линии. - 🔄 Использовать rebase:
git pull --rebaseперенесёт ваши коммиты поверх свежих серверных, история останется линейной.
⚠️ Внимание: командаgit stash popпосле обновления может вызвать конфликт, если вы и ваши коллеги правили одни и те же строки. В этом случае Git пометит спорные места маркерами<<<<<<<и>>>>>>>— их нужно разрешить вручную в редакторе.
Какой вариант выбрать? Если правки небольшие и вы планируете их отправить на сервер — коммитьте и делайте pull. Если это временные эксперименты, которые не должны попасть в историю, удобнее stash.
Принудительное обновление: когда локальные изменения не нужны
Иногда локальная копия «сломана» экспериментами, и проще вернуть её к точному состоянию сервера. Для этого существует жёсткий сброс:
git fetch origin
git reset --hard origin/main
После этих двух команд ваша папка станет байт-в-байт идентичной удалённой ветке — все незакоммиченные правки и локальные коммиты будут безвозвратно удалены. Это самый радикальный способ «обновить» репозиторий, и отменить его штатными средствами сложно.
⚠️ Внимание: передgit reset --hardубедитесь, что в папке нет нужных файлов, которых нет на GitHub. Если сомневаетесь — скопируйте изменённые файлы в отдельный каталог или сначала выполнитеgit stash, чтобы оставить путь к отступлению.
Решение типичных ошибок при обновлении
Разберём сообщения, которые чаще всего появляются при попытке обновить репозиторий, и что с ними делать.
- 🔐 Authentication failed — GitHub больше не принимает пароль для операций по HTTPS; нужен Personal Access Token вместо пароля либо настройка SSH-ключа. Токен создаётся в настройках аккаунта GitHub, раздел Developer settings.
- 🔀 Merge conflict — откройте конфликтные файлы, выберите нужные фрагменты между маркерами, затем выполните
git addиgit commit. - 📂 Not a git repository — терминал открыт не в той папке; перейдите в каталог, где лежит скрытая папка
.git. - ⏪ Non-fast-forward — истории разошлись; помогут
git pull --rebaseили ручное слияние.
Отдельный случай — ошибка refusing to merge unrelated histories. Она возникает, когда локальный и удалённый репозитории создавались независимо друг от друга. Если вы уверены, что их нужно объединить, используйте git pull origin main --allow-unrelated-histories, но сначала подумайте, не проще ли склонировать репозиторий заново и перенести свои файлы.
Как обновить репозиторий через GitHub Desktop
Откройте приложение GitHub Desktop и выберите нужный репозиторий в списке слева. Нажмите кнопку Fetch origin в верхней панели — программа проверит наличие новых коммитов. Если обновления найдены, кнопка сменится на Pull origin — нажмите её, чтобы скачать и применить изменения. При конфликтах приложение предложит открыть файлы в редакторе и разрешить их вручную.
Обновление форка и синхронизация с оригиналом
Если вы работаете с форком чужого проекта, обычный git pull обновит копию только до состояния вашего форка, а не исходного репозитория. Чтобы подтянуть свежие коммиты из оригинального проекта, необходимо добавить его как второй удалённый источник:
git remote add upstream https://github.com/автор/репозиторий.git
git fetch upstream
git merge upstream/main
Проверить, какие источники уже подключены, можно командой git remote -v — в выводе появятся строки origin (ваш форк) и upstream (оригинал). После слияния не забудьте отправить обновления в свой форк командой git push origin main, иначе на GitHub всё останется по-старому.
⚠️ Внимание: адрес оригинального репозитория копируйте с его страницы на GitHub через кнопку Code. Опечатка в URL приведёт к ошибке подключения, а в худшем случае — к слиянию с чужим одноимённым проектом.
Частые вопросы
Чем отличается обновление репозитория от повторного клонирования?
Клонирование (git clone) создаёт полную копию с нуля в новой папке, включая всю историю. Обновление через git pull скачивает только новые коммиты в существующую копию — это быстрее и сохраняет ваши локальные ветки и настройки.
Как обновить репозиторий, если я работаю не в ветке main?
Подставьте имя своей ветки в команду: git pull origin имя-ветки. Узнать текущую ветку поможет git branch --show-current.
Почему git pull требует логин и пароль, но пароль не подходит?
GitHub отключил аутентификацию по паролю для Git-операций. Вместо пароля используйте персональный токен доступа (Personal Access Token), созданный в настройках аккаунта, или настройте подключение по SSH.
Можно ли обновить репозиторий без командной строки?
Да. Графические клиенты вроде GitHub Desktop, GitKraken или встроенные инструменты IDE (например, Visual Studio Code) выполняют fetch и pull кнопками. Под капотом они вызывают те же команды Git.
Что делать, если после обновления проект перестал запускаться?
Возможная причина — изменения в зависимостях или конфигурации, пришедшие с новыми коммитами. Проверьте файл README и историю коммитов (git log --oneline) на предмет новых требований, переустановите зависимости проекта. Вернуться к предыдущему состоянию поможет git reset --hard с хешем нужного коммита.