Настроить Git и сделать первый pull request
Установите Git, подключите GitHub по SSH и отправите первый pull request в открытый проект — после этого Git перестаёт пугать.
с прогрессом
- 1
Установить Git
≈ 5 минВозможно, Git уже стоит: откройте терминал и выполните
git --version. Если команда не найдена — установите:- Windows:
winget install --id Git.Git -eили установщик с git-scm.com. Вместе с Git поставится Git Bash — дальше команды удобно выполнять в нём. - macOS:
xcode-select --installилиbrew install git. - Ubuntu / Debian:
sudo apt install git.
После установки перезапустите терминал и проверьте ещё раз:
git --version- Команда git --version выводит номер версии
- Windows:
- 2
Представиться Git
≈ 3 минКаждый коммит подписывается именем и почтой. Задайте их один раз:
git config --global user.name "Иван Петров" git config --global user.email "ivan@example.com" git config --global init.defaultBranch mainПочта должна совпадать с той, что привязана к аккаунту GitHub, иначе коммиты не свяжутся с вашим профилем. Не хотите светить почту — возьмите адрес вида
ID+логин@users.noreply.github.comв GitHub → Settings → Emails.Проверьте, что всё сохранилось:
git config --global --list.- git config --global --list показывает user.name и user.email
- Почта совпадает с почтой аккаунта GitHub
- 3
Подключить GitHub: через GitHub CLI или по SSH
≈ 15 минGitHub не принимает пароль от аккаунта для
git push. Есть два способа авторизоваться — выберите один.Способ 1. GitHub CLI — проще всего. Установите
gh(winget install --id GitHub.cliилиbrew install gh) и выполните:gh auth loginВыберите GitHub.com → SSH → согласитесь создать новый SSH-ключ → войдите через браузер. Утилита сама создаст ключ и добавит его в аккаунт.
Способ 2. SSH-ключ вручную.
ssh-keygen -t ed25519 -C "ivan@example.com" cat ~/.ssh/id_ed25519.pubСкопируйте именно файл
.pubи вставьте его в GitHub → Settings → SSH and GPG keys → New SSH key.Проверка для обоих способов:
ssh -T git@github.comОтвет Hi логин! You’ve successfully authenticated — всё готово.
- Публичный ключ добавлен в GitHub → Settings → SSH and GPG keys
- ssh -T git@github.com отвечает «You've successfully authenticated»
- 4
Сделать форк и склонировать репозиторий
≈ 5 минДля тренировки идеально подходит репозиторий firstcontributions/first-contributions на GitHub — он создан, чтобы новички делали в него первый PR.
- Откройте репозиторий и нажмите Fork → Create fork. В вашем аккаунте появится копия.
- В своей копии нажмите Code → вкладка SSH и скопируйте адрес.
- Склонируйте форк и добавьте оригинал как
upstream:
git clone git@github.com:ВАШ_ЛОГИН/first-contributions.git cd first-contributions git remote add upstream git@github.com:firstcontributions/first-contributions.git git remote -vorigin— ваш форк,upstream— оригинал. Пушить вы будете вorigin.- Форк появился в моём аккаунте GitHub
- git remote -v показывает origin и upstream
- 5
Создать ветку и внести изменение
≈ 10 минНе работайте прямо в
main— для каждой задачи своя ветка:git switch -c add-ivan-petrovОткройте в редакторе файл
Contributors.mdи добавьте строку со своим именем в том же формате, что у остальных. Посмотрите, что изменилось:git status git diffgit statusпокажет изменённый файл,git diff— добавленную строку с плюсом.- Создана отдельная ветка, правки не в main
- git diff показывает мою добавленную строку
- 6
Закоммитить и отправить ветку
≈ 5 минgit add Contributors.md git commit -m "Add Ivan Petrov to Contributors list" git push -u origin add-ivan-petrovgit add— отметить, что войдёт в коммит;git commit -m— сохранить снимок с сообщением. Пишите по делу и в повелительном наклонении: «Add…», «Fix…», а не «правки» или «asdf»;git push -u origin …— отправить ветку в ваш форк. Флаг-uнужен только в первый раз, дальше хватитgit push.
- git log --oneline показывает мой коммит
- git push завершился без ошибок
- 7
Открыть pull request
≈ 10 минОткройте свой форк на GitHub — сверху появится плашка Compare & pull request. Нажмите её.
Проверьте направление: base repository — оригинал, ветка
main; head repository — ваш форк и ваша ветка. Затем:- заголовок — коротко, что сделано;
- описание — зачем изменение и как его проверить. Если в проекте есть шаблон PR, заполните его, а не удаляйте;
- нажмите Create pull request.
Если в проекте настроены автоматические проверки (CI), они запустятся сами — дождитесь зелёных галочек.
- PR открыт из моей ветки в main оригинального репозитория
- У PR понятный заголовок и описание
- 8
Ответить на ревью и обновить PR
≈ 10 минМейнтейнеры могут попросить что-то поправить — это нормально, замечания не про вас, а про код.
Чтобы обновить PR, сделайте новые коммиты в ту же ветку и запушьте — pull request обновится сам:
git add . git commit -m "Fix typo in name" git pushЕсли
mainв оригинале ушёл вперёд и появились конфликты, подтяните изменения:git fetch upstream git merge upstream/mainРазрешите конфликты в редакторе, закоммитьте и запушьте. Когда PR примут, ветку можно удалить кнопкой Delete branch.
- Ответил на все комментарии ревьюера
- Новые коммиты появились в том же PR