Git и GitHub в IDE: от коммита до Pull Request
Что такое коммит, локальный репозиторий и GitHub. Добавьте тест-кейс в репозиторий команды кнопками IDE: Clone, новая ветка, Commit, Push, Pull Request, ревью, Merge и Update Project.
О продукте
Привет! В нашей команде тест-кейсы хранятся не в таблице, а в Git-репозитории на GitHub, рядом с кодом. Так видно, кто, когда и что поменял, а каждое изменение проходит ревью. Тебе нужно добавить новый тест-кейс: блокировку входа после трёх неверных паролей.
Звучит интересно! А как это сделать?
Через Pull Request, как и все в команде. Кадри покажет весь путь: скачаешь репозиторий, создашь ветку, сделаешь коммит, отправишь его на GitHub, откроешь Pull Request, пройдёшь ревью и сольёшь изменения в main.
Привет! Всё сделаем в IDE: кнопками, без команд. Но сначала — общая картина: где лежит проект и как твои изменения попадают к коллегам.
Привет, Кадри! Расскажи, как это устроено?
У каждого в команде есть своя копия проекта на компьютере, а общая версия лежит на GitHub. Изменения ходят между ними по стрелкам:
Твой компьютер
GitHub — общая база
версия проекта, которую видит вся командаPull Request · reviewКоллеги
у каждого своя копияКоммит
Точка сохранения, как в игре: снимок файлов с описанием, автором и временем. К любому коммиту можно вернуться, и всегда видно, кто что поменял.
Локальный репозиторий
Проект на твоём компьютере вместе со всей историей коммитов. Коммит сначала попадает сюда: коллеги его не видят, и интернет для этого не нужен.
GitHub — общая база
Удалённый репозиторий команды, Git называет его origin. Push отправляет туда твои коммиты, pull забирает оттуда коммиты коллег. Здесь же проходят Pull Request и ревью.
IDE
IDE — программа для работы с файлами проекта. Git в неё встроен: вместо команд — кнопки, а под капотом выполняются те же команды Git.
Проверим. Ты только что сделал коммит. Где он сейчас?
Понятно! А что ещё встретится по пути?
Ещё несколько слов, которые понадобятся сегодня:
Словарик
clone— скачать репозиторий с GitHub к себе. Делают один раз, в начале работы с проектомветка(branch) — отдельная линия работы. Главная веткаmain— проверенная версия, а для каждой задачи создают свою веткуpush— отправить свои коммиты на GitHubpull— забрать новые коммиты с GitHub. В IDE эта кнопка называется Update ProjectPull Request (PR)— запрос на слияние твоей ветки вmain: коллеги проверяют изменения перед слиянием
Коллега хочет увидеть твой коммит. Что нужно сделать?
Всё ясно! Открываю IDE.
Рабочее место
Шаг 1 · Клонирование
Первым делом получим проект на твой компьютер. Для этого репозиторий клонируют: Git скачивает с GitHub все файлы и всю историю, и у тебя появляется свой локальный репозиторий.
Как это сделать в IDE?
В окне GitHub под IDE нажми зелёную кнопку Code и скопируй адрес. Потом в IDE на экране приветствия выбери Get from VCS, проверь адрес и нажми Clone.
Подсказка
Где нажимать:
GitHub: Code → ⧉ IDE: Get from VCS → Clone
То же в терминале:
git clone https://github.com/bb-food/shop-tests.git
Рабочая папка
Отмечено для коммита
☑Локальный репозиторий
CommitGitHub (origin)
PushIDEDevelopment environment
- Projects
- Customize
- Plugins
- Learn
Welcome to the IDE
Create a new project to start from scratch.
Open existing project from disk or version control.
Готово! IDE скачала проект и открыл его: слева дерево файлов, внизу окно Git с историей коммитов. На схеме файлы появились в рабочей папке, а в локальном репозитории — ветка main с двумя коммитами. Загляни во вкладку Console внизу: IDE выполнила ту же команду git clone, что вводят в терминале.
Что делает Clone?
Можно сразу менять файл?
Шаг 2 · Новая ветка
Почти. В main лежит проверенная версия, которой пользуется вся команда, поэтому напрямую в неё не пишут. Для каждой задачи создают свою ветку: в ней можно спокойно работать, не мешая другим.
Как создать ветку?
Нажми на имя ветки main в верхней панели IDE и выбери New Branch… Введи имя test/login-lockout и нажми Create. Галочка Checkout branch сразу переключит тебя на новую ветку.
Подсказка
Где нажимать:
⎇ main ▾ → New Branch… test/login-lockout → Create
То же в терминале:
git switch -c test/login-lockout
Ты в ветке test/login-lockout: её имя теперь в верхней панели и в строке состояния. Пока ветка — просто новая метка на том же коммите, что и main. Всё, что ты закоммитишь дальше, попадёт только в неё.
Перед коммитом всегда смотри на имя ветки в верхней панели. Коммит «не в ту ветку» — самая частая ошибка новичков.
Зачем создавать отдельную ветку для задачи?
Теперь пишу тест-кейс!
Шаг 3 · Изменения
Да! Открой файл с тест-кейсами блокировки входа и добавь новый кейс. Git сразу заметит, что файл изменился, но сам сохранять изменение в историю не станет.
Как увидеть, что заметил Git?
Нажми в редакторе «Вставить тест-кейс TC-02», а потом открой слева окно Commit (вторая иконка на боковой панели). В нём собраны все изменённые файлы — то же самое показывает команда git status.
Подсказка
Где нажимать:
Редактор: «Вставить тест-кейс TC-02» Боковая панель: Commit
То же в терминале:
git status
Файл в списке Changes, и IDE подсвечивает его синим — в дереве проекта, на вкладке и в окне Commit. Зелёные полоски у номеров строк отмечают новые строки. Но галочки у файла пока нет: он изменён, но не выбран для коммита.
Файл в списке Changes, но без галочки. Попадёт ли он в коммит?
А как выбрать файл?
Шаг 4 · Выбор файлов
В Git есть индекс (staging area) — «корзина» для следующего коммита. Ты сам решаешь, что в неё положить: в терминале это команда git add, а в IDE — галочка у файла. Если ты поменял пять файлов, а к задаче относятся два, отметь только их.
Где ставить галочку?
Поставь галочку у файла login-lockout.md в окне Commit.
Подсказка
Где нажимать:
Commit → Changes → ☑ login-lockout.md
То же в терминале:
git add test-cases/login-lockout.md
Файл выбран для коммита: на схеме он переехал во вторую колонку. Всё отмеченное войдёт в коммит, а неотмеченное останется в рабочей папке.
Теперь коммит?
Шаг 5 · Коммит
Да. Коммит сохраняет отмеченные изменения в историю как снимок: с автором, временем, уникальным номером (хешем) и описанием. Хорошее описание коротко говорит, что сделано. В командах его обычно пишут по-английски.
Где написать описание?
Впиши в поле Commit Message описание Add TC-02 login lockout test case и нажми Commit.
Подсказка
Где нажимать:
Commit Message: Add TC-02 login lockout test case Commit
То же в терминале:
git commit -m "Add TC-02 login lockout test case"
Коммит создан: он появился внизу в окне Git → Log со своим хешем, а файл больше не синий. Но обрати внимание: коммит есть только в твоём локальном репозитории. На GitHub его пока никто не видит.
Ты сделал коммит. Видят ли его коллеги на GitHub?
Как отправить его на GitHub?
Шаг 6 · Push
Push отправляет коммиты из твоей ветки на GitHub. Ветки test/login-lockout на GitHub ещё нет, но IDE сама это заметит и создаст её.
Где эта кнопка?
Нажми в верхней панели IDE стрелку Push (↗). В окне Push Commits проверь, что ветка уходит в origin : test/login-lockout с пометкой New, и нажми Push.
Подсказка
Где нажимать:
Верхняя панель: ↗ Push Push Commits → Push
То же в терминале:
git push -u origin test/login-lockout
Ветка и коммит теперь на GitHub: посмотри на четвёртую колонку. GitHub заметил новую ветку и сразу предлагает открыть Pull Request. А во вкладке Console видно команду git push --set-upstream origin test/login-lockout: IDE за тебя связала ветку с веткой на GitHub.
Чем Commit отличается от Push?
Открываю Pull Request!
Шаг 7 · Pull Request
Pull Request — это просьба: «посмотрите мои изменения и влейте ветку в main». В PR видно все коммиты и изменения построчно, коллеги оставляют комментарии, а автоматические проверки (CI) прогоняют тесты.
Что указать в PR?
В окне GitHub нажми Compare & pull request. Проверь, что сливаешь test/login-lockout в main, и оставь понятные название и описание: что сделано и зачем. Потом нажми Create pull request.
Подсказка
Где нажимать:
GitHub: Compare & pull request Create pull request
PR открыт, проверки прошли. Но я оставила замечание и запросила изменения (Changes requested): в TC-02 нет ожидаемого результата. Это обычная часть работы: ревью для того и нужно, чтобы находить такое до слияния.
Для тестировщика PR — важный источник информации: во вкладке Files changed видно, что именно поменялось, и по этому удобно планировать проверку.
Зачем команда использует Pull Request, а не сливает ветки сразу?
Как исправить замечание?
Шаг 8 · Исправление после ревью
Новый PR открывать не нужно. Достаточно добавить новый коммит в ту же ветку и отправить его: PR следит за веткой и обновится сам.
Повторить те же шаги?
Да, тот же цикл. Нажми в редакторе «Вставить ожидаемый результат», отметь файл галочкой, впиши описание Add expected result to TC-02 и нажми Commit and Push… — так коммит и push делаются за один раз. В окне Push Commits нажми Push.
Подсказка
Где нажимать:
Редактор: «Вставить ожидаемый результат» ☑ login-lockout.md Commit Message: Add expected result to TC-02 Commit and Push… → Push
То же в терминале:
git add test-cases/login-lockout.md git commit -m "Add expected result to TC-02" git push
Новый коммит появился в PR, проверки снова прошли, и я одобрила изменения (Approved). Теперь PR можно сливать.
Ревьюер попросил исправить PR. Что делать?
Сливаю!
Шаг 9 · Merge
Слияние (merge) переносит коммиты ветки в main. У нас есть одобрение и зелёные проверки — всё, что требуют правила команды.
Где эта кнопка?
Нажми на GitHub Merge pull request, а затем Confirm merge.
Подсказка
Где нажимать:
GitHub: Merge pull request → Confirm merge
PR слит: твой тест-кейс теперь в main на GitHub, его видит вся команда. Ветку test/login-lockout на GitHub можно удалить, работа в ней закончена.
PR слит на GitHub. Есть ли новый тест-кейс в ветке main на твоём компьютере?
Как обновить main?
Шаг 10 · Update Project
Вернись в main и забери изменения с GitHub. В IDE для этого есть Update Project (синяя стрелка ↙): она скачивает новые коммиты и добавляет их в текущую ветку, как git pull. Так делают перед каждой новой задачей.
Как это сделать?
Нажми на имя ветки в верхней панели, выбери main и нажми Checkout. Посмотри на редактор. Потом нажми Update Project (↙) и в окне нажми OK.
Подсказка
Где нажимать:
⎇ test/login-lockout ▾ → main → Checkout Верхняя панель: ↙ Update Project → OK
То же в терминале:
git switch main git pull
Локальный main догнал GitHub: в нём твои коммиты и коммит слияния. Кстати, сразу после переключения тест-кейса в файле не было: твой компьютер ещё не знал о слиянии на GitHub. Git сам в сеть не ходит, поэтому перед работой всегда нажимают Update Project.
Спасибо, Кадри!
Ты прошёл весь путь изменения в команде: Clone → New Branch → галочка → Commit → Push → Pull Request → ревью → Merge → Update Project. Этот цикл повторяется в каждой задаче. В терминале всё то же делают командами git clone, git switch -c, git add, git commit, git push и git pull.
Справка по теме
Git и GitHub
Git — система контроля версий на компьютере: хранит историю изменений файлов. GitHub — общая база команды: удалённый репозиторий (origin), где лежит версия проекта для всех и проходят Pull Request и ревью.
Коммит и локальный репозиторий
Коммит — снимок изменений с описанием, автором, временем и хешем. Сначала он попадает в локальный репозиторий на вашем компьютере: коллеги его не видят, пока вы не сделаете push.
Ветки в IDE
Имя текущей ветки — в верхней панели. По клику на него: New Branch… создаёт ветку (с галочкой Checkout branch сразу переключает на неё), а выбор ветки и Checkout — переключает на существующую.
Commit в IDE
Окно Commit показывает изменённые файлы (они синие). Галочка у файла — это индекс (git add): в коммит попадут только отмеченные файлы. Описание пишут в поле Commit Message и нажимают Commit или Commit and Push….
Push и Update Project
Push (↗) отправляет коммиты ветки на GitHub; новую ветку IDE создаёт там сама. Update Project (↙) скачивает новые коммиты с GitHub в текущую ветку, как git pull. Сам Git в сеть не ходит.
Pull Request и ревью
PR — запрос на слияние ветки в main. В нём видны коммиты и изменения построчно (Files changed), идут автоматические проверки (CI), коллеги одобряют (Approve) или просят исправить (Request changes). Исправления — новые коммиты в ту же ветку.
IDE и терминал
Get from VCS = git clone, New Branch = git switch -c, галочка = git add, Commit = git commit, Push = git push, Update Project = git pull. Какие команды выполнила IDE, видно во вкладке Git → Console.