Как пользоваться GitHub Desktop: первый репозиторий и коммит

Инструкция для Windows 11, на Mac порядок тот же, отличается только расположение настроек. Интерфейс программы на английском, поэтому кнопки приводим в оригинале и объясняем, что они делают. Для публикации проекта понадобится бесплатный аккаунт на GitHub — его можно завести заранее на сайте.

Скачайте и установите программу

Откройте desktop.github.com и нажмите кнопку загрузки для Windows. Запустите скачанный файл: установщик ничего не спрашивает, программа сама поставится в папку вашего пользователя и откроется. Права администратора не нужны.

Можно установить и через менеджер пакетов Windows:

winget install GitHub.GitHubDesktop

Войдите в аккаунт GitHub

На приветственном экране нажмите кнопку входа в GitHub.com. Откроется браузер со страницей GitHub: войдите в аккаунт и разрешите доступ для GitHub Desktop. Браузер вернёт вас в программу, и вход будет выполнен.

Если аккаунта пока нет или вы хотите работать только с папками на компьютере, пропустите этот шаг — войти можно позже в настройках.

Укажите имя и почту для коммитов

Программа предложит настроить Git: имя и почту, которыми будут подписаны ваши коммиты. Если вы вошли в аккаунт, можно взять данные из него. Почта должна совпадать с почтой в аккаунте GitHub — тогда коммиты появятся в вашем профиле.

Создайте или добавьте репозиторий

На стартовом экране есть несколько вариантов. Выберите подходящий:

• Create a New Repository — новый проект. Укажите название, папку, где он будет лежать, и по желанию добавьте файл README с описанием, шаблон .gitignore для вашего языка и лицензию.
• Add an Existing Repository — у вас уже есть папка с проектом. Если в ней ещё нет Git, программа предложит создать репозиторий прямо в ней.
• Clone a Repository — скачать проект с GitHub или по адресу с другого хостинга. Выберите репозиторий из списка или вставьте адрес и укажите папку.
• Учебный репозиторий — программа может создать тренировочный проект и по шагам показать, как делать изменения, коммиты и запросы на слияние.

Сделайте первый коммит

Откройте проект в редакторе — в меню программы есть команда открыть его в выбранном редакторе кода — и поменяйте что-нибудь. Вернитесь в GitHub Desktop: на вкладке изменений слева появится список файлов, справа — что именно поменялось.

Оставьте галочки только у тех файлов, которые хотите сохранить. Внизу слева впишите короткий комментарий в поле Summary, например «Добавил страницу контактов», при необходимости — подробности в поле описания. Нажмите синюю кнопку Commit to main. Изменения сохранены в истории, но пока только на вашем компьютере.

Опубликуйте проект на GitHub

Для нового репозитория в верхней панели появится кнопка Publish repository. Нажмите её, проверьте название и решите, будет ли репозиторий частным: галочка о сохранении кода закрытым по умолчанию включена. После публикации проект появится в вашем аккаунте на GitHub.

Отправляйте и забирайте изменения

Дальше работа идёт по кругу: правите файлы, делаете коммит, нажимаете Push origin в верхней панели — и коммиты уходят на сервер. Если кто-то ещё работает над проектом или вы правили его с другого компьютера, нажмите Fetch origin, а затем Pull origin, чтобы забрать новые изменения.

Для отдельной задачи создайте ветку: откройте список Current branch, выберите создание новой ветки и дайте ей название. Когда работа готова, опубликуйте ветку и нажмите кнопку создания pull request — откроется страница GitHub, где изменения можно обсудить и слить с основной веткой.

Если что-то пошло не так