Команда git push завершается ошибкой «remote: Repository not found» — чаще всего причина в том, что репозиторий на GitHub ещё не создан, а локальный проект пытается отправиться в несуществующий удалённый адрес. Чтобы загрузить свой код на GitHub, нужно пройти три обязательных этапа: создать удалённый репозиторий на сайте, инициализировать Git в папке проекта и связать их между собой.
Ниже разобраны все способы публикации кода: через командную строку, через веб-интерфейс GitHub и через графические клиенты. Инструкция подходит для Windows, macOS и Linux — команды Git везде одинаковые, отличается только способ установки самого инструмента.
Подготовка: аккаунт и установка Git
Перед загрузкой кода потребуется учётная запись на GitHub и установленная система контроля версий Git. Регистрация на сайте бесплатна и занимает пару минут: нужен email, пароль и имя пользователя, которое станет частью адреса всех ваших репозиториев.
Установка Git зависит от операционной системы:
- 🪟 Windows — скачайте установщик с официального сайта git-scm.com и установите с настройками по умолчанию, в комплект входит Git Bash.
- 🍎 macOS — выполните в терминале команду
git --version, система сама предложит установить инструменты разработчика, если Git отсутствует. - 🐧 Linux — установите пакет через менеджер пакетов, например
sudo apt install gitдля Debian/Ubuntu.
После установки проверьте результат командой git --version. Если терминал выводит номер версии — всё готово к работе. Если команда не распознаётся, перезапустите терминал или проверьте переменную PATH.
Создание репозитория на GitHub
Репозиторий — это хранилище проекта на серверах GitHub. Чтобы его создать, нажмите кнопку New на главной странице после входа в аккаунт или значок «+» в правом верхнем углу и выберите New repository.
Форма создания содержит несколько важных полей. Repository name — имя проекта, оно войдёт в URL. Public/Private — видимость: публичный репозиторий виден всем, приватный — только вам и приглашённым участникам. Галочка Add a README file создаёт начальный файл описания.
⚠️ Внимание: если планируете загружать уже существующий локальный проект, не ставьте галочки на создание README, .gitignore и лицензии. Иначе удалённый репозиторий получит собственную историю коммитов, и при первом push возникнет конфликт, который придётся разрешать слиянием.
Загрузка кода через командную строку
Это основной и самый гибкий способ. Откройте терминал и перейдите в папку с вашим проектом командой cd путь/к/папке. Дальнейшие действия выполняются один раз при первой публикации.
Последовательность команд для первой загрузки:
git init
git add .
git commit -m "Первый коммит"
git branch -M main
git remote add origin https://github.com/имя/репозиторий.git
git push -u origin main
Разберём, что делает каждая строка. git init превращает папку в локальный репозиторий, создавая скрытую директорию .git. Команда git add . добавляет все файлы проекта в индекс — список того, что войдёт в коммит. git commit фиксирует снимок изменений с поясняющим сообщением, а git push отправляет коммиты на сервер.
☑️ Первая загрузка проекта на GitHub
При последующих обновлениях кода достаточно трёх команд: git add ., git commit -m "описание изменений" и git push. Параметр -u при первой отправке связывает локальную ветку с удалённой, поэтому дальше адрес указывать не нужно.
Загрузка файлов через веб-интерфейс
Если проект небольшой или командная строка недоступна, код можно загрузить прямо в браузере. Откройте созданный репозиторий и нажмите кнопку Add file → Upload files. Затем перетащите файлы в область загрузки или выберите их через диалог.
После выбора файлов внизу страницы появится поле Commit changes — введите краткое описание загрузки и подтвердите. Файлы сразу появятся в репозитории как отдельный коммит.
У этого способа есть ограничения: загрузка множества вложенных папок может работать медленно, а для регулярной разработки браузерный метод неудобен. Он подходит для разовой публикации готового результата или небольших правок через кнопку редактирования файла.
Сравнение способов загрузки
| Способ | Сложность | Когда подходит |
|---|---|---|
| Командная строка (Git) | Средняя | Регулярная разработка, полный контроль версий |
| Веб-интерфейс GitHub | Низкая | Разовая загрузка, мелкие правки |
| GitHub Desktop | Низкая | Новички, визуальное управление коммитами |
| Интеграция в IDE (VS Code и др.) | Низкая | Работа без выхода из редактора кода |
Графический клиент GitHub Desktop дублирует возможности командной строки кнопками: клонирование, коммиты и push выполняются через интерфейс. Многие редакторы кода, включая Visual Studio Code, имеют встроенную панель Git, где те же действия доступны из бокового меню.
Что такое файл .gitignore и зачем он нужен
Это текстовый файл со списком путей, которые Git должен игнорировать: папки сборки, зависимости (node_modules), файлы с паролями и ключами, временные файлы IDE. Создайте .gitignore в корне проекта до первого коммита, чтобы случайно не опубликовать служебные данные.
Типичные ошибки при загрузке и их решение
Самая частая проблема — запрос логина и пароля при git push, после которого GitHub отклоняет авторизацию. Причина в том, что для операций через HTTPS обычный пароль аккаунта не принимается: вместо него используется персональный токен доступа, который создаётся в настройках профиля в разделе Developer settings → Personal access tokens. Альтернатива — настройка SSH-ключей, после которой пароль вообще не запрашивается.
- 🔑 Ошибка «Permission denied» — проверьте, что токен обладает нужными правами или SSH-ключ добавлен в аккаунт.
- 📦 Ошибка «failed to push some refs» — удалённый репозиторий содержит коммиты, которых нет локально; сначала выполните
git pullи разрешите конфликты. - 📁 Файлы не попадают в коммит — проверьте
git status: возможно, они исключены правилами .gitignore.
⚠️ Внимание: никогда не публикуйте в репозитории пароли, API-ключи и файлы конфигурации с секретными данными. Даже после удаления файла он остаётся в истории коммитов, и скомпрометированный ключ придётся менять на стороне сервиса.
Часто задаваемые вопросы
Можно ли загрузить код на GitHub без установки Git?
Да, через веб-интерфейс: кнопка Add file → Upload files в созданном репозитории позволяет перетащить файлы прямо в браузере. Однако для полноценной работы с версиями установка Git всё же потребуется.
Чем отличается публичный репозиторий от приватного?
Публичный репозиторий виден любому пользователю интернета, его код можно просматривать и клонировать. Приватный доступен только вам и людям, которых вы явно пригласили как соавторов.
Как обновить уже загруженный код?
Внесите изменения в файлы, затем выполните три команды: git add ., git commit -m "описание правок" и git push. Новая версия появится в репозитории как отдельный коммит с сохранением всей истории.
Что делать, если случайно загрузил лишний файл?
Удалите его командой git rm имя_файла, сделайте коммит и выполните push. Учтите: файл останется в истории предыдущих коммитов, поэтому секретные данные после такой утечки нужно считать скомпрометированными.
Можно ли загрузить проект с телефона?
Мобильная версия сайта и официальное приложение GitHub позволяют просматривать репозитории и редактировать отдельные файлы, но полноценная загрузка проекта с телефона затруднена. Для серьёзной работы используйте компьютер.