Git для студента: сохранить лабораторную и не потерять код

Как вести лабораторную в Git: init, add, commit, diff, откат файла, .gitignore, ветка для эксперимента, GitHub, что не коммитить и что значат частые ошибки.

Папка с файлами lab3.py, lab3_new.py и lab3_final_2.py, а рабочая версия была где-то позавчера. Знакомо? Git решает ровно эту задачу: он хранит каждую сохранённую версию проекта и позволяет вернуться к любой. Ниже набор команд, которого хватает на все лабораторные, с настоящим выводом Git 2.50 и разбором ошибок, на которых застревают в первый раз.

Первая настройка

Проверьте, что Git установлен: git --version. Затем один раз представьтесь. Без этого первый коммит не пройдёт:

Author identity unknown

*** Please tell me who you are.

Run

  git config --global user.email "you@example.com"
  git config --global user.name "Your Name"
git config --global user.name "Анна Петрова"
git config --global user.email "anna@example.com"
git config --global init.defaultBranch main

Третья строка задаёт имя основной ветки main. Без неё Git назовёт ветку master и выведет длинную подсказку. Это не ошибка, но GitHub и многие инструкции ждут main.

Репозиторий и .gitignore

Перейдите в папку лабораторной и создайте репозиторий:

cd lab1
git init
Initialized empty Git repository in /home/student/lab1/.git/

Создавайте его в папке проекта, а не в домашней. Если запустить команду Git вне репозитория, получите fatal: not a git repository (or any of the parent directories): .git.

Сразу посмотрите, что Git видит:

$ git status
On branch main

No commits yet

Untracked files:
  (use "git add <file>..." to include in what will be committed)
	.env
	.venv/
	__pycache__/
	main.py

nothing added to commit but untracked files present (use "git add" to track)

Из этого списка в репозиторий нужен только main.py. Остальное перечислите в файле .gitignore, тогда Git перестанет это замечать:

__pycache__/
.venv/
.env
*.o
*.class
*.exe
build/

Сюда же идут папки настроек среды разработки, большие наборы данных и всё, что получается при сборке.

Сохранить версию: add и commit

Каждый коммит хранит снимок проекта с подписью. Сохранение идёт в два шага: git add выбирает, что войдёт в снимок, git commit его создаёт.

Длинный деревянный ящик-картотека, в который войлочная рука ставит новую бумажную карточку в конец ряда

$ git add .gitignore main.py
$ git commit -m "Первая версия: среднее по списку"
[main (root-commit) 43d3d95] Первая версия: среднее по списку
 2 files changed, 7 insertions(+)
 create mode 100644 .gitignore
 create mode 100644 main.py

Коммитьте каждый раз, когда программа в рабочем состоянии: решили пункт задания, исправили ошибку. В подписи пишите, что изменилось: «Пустой список не ломает mean» понятнее, чем «правки».

Что изменилось: diff и log

git diff показывает изменения, которые ещё не добавлены через add:

$ git diff
diff --git a/main.py b/main.py
index 5960035..0317f9c 100644
--- a/main.py
+++ b/main.py
@@ -1,4 +1,7 @@
 def mean(xs):
+    if not xs:
+        return 0
     return sum(xs) / len(xs)
 
 print(mean([5, 4, 3]))
+print(mean([]))

Строки с + добавлены, с - удалены. Изменения, уже добавленные через add, показывает git diff --staged. Историю коммитов коротко выводит git log --oneline:

bb02208 Пустой список не ломает mean
43d3d95 Первая версия: среднее по списку

Слева стоят первые семь символов хеша коммита. По ним коммит называют в командах.

Как откатить изменения

Ситуация Команда
Испортили файл и ещё не делали add git restore main.py
Добавили через add лишнее git restore --staged main.py
Посмотреть версию файла из прошлого коммита git show HEAD~1:main.py
Вернуть файл к версии из прошлого коммита git restore --source=HEAD~1 main.py
Отменить коммит целиком, сохранив историю git revert HEAD

HEAD обозначает последний коммит, HEAD~1 предыдущий. Вместо них можно писать хеш из git log, например git restore --source=43d3d95 main.py.

Команды git restore и git switch появились в Git 2.23. В старых инструкциях вместо них встречается git checkout.

Осторожно: git restore main.py стирает незакоммиченные правки в файле, вернуть их Git не сможет. То же делает git reset --hard, его новичку лучше не трогать. git revert безопаснее: он не удаляет коммит, а создаёт новый, обратный ему.

Ветка для эксперимента

Хотите попробовать другой алгоритм и не испортить рабочую версию? Заведите ветку:

git switch -c experiment
# правишь код, коммитишь как обычно
git commit -am "Пробую statistics.fmean"
git switch main

В main файл остался прежним. Эксперимент удался, тогда влейте его в main:

$ git merge experiment
Updating bb02208..a7e76a5
Fast-forward
 main.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

Не удался: удалите ветку командой git branch -D experiment. С маленькой -d Git откажется удалять невлитую ветку: error: the branch 'experiment' is not fully merged.

Перед переключением веток закоммитьте правки, иначе Git остановится:

error: Your local changes to the following files would be overwritten by checkout:
	main.py
Please commit your changes or stash them before you switch branches.
Aborting

Удалённый репозиторий

Копия на GitHub, GitLab или другом сервисе спасает, если сломается ноутбук, и позволяет работать с двух компьютеров. Создайте на сайте пустой репозиторий без README и подключите его:

git remote add origin https://github.com/<логин>/lab1.git
git push -u origin main

-u нужен один раз, дальше достаточно git push. Если работа учебная, делайте репозиторий закрытым (private), чтобы решение не скопировали.

GitHub не принимает пароль от аккаунта при работе по HTTPS. В документации GitHub сказано: когда Git спросит пароль, вводите персональный токен доступа.

Если в репозиторий уже отправили коммиты с другого компьютера, Git откажет:

 ! [rejected]        main -> main (fetch first)
error: failed to push some refs to 'https://github.com/<логин>/lab1.git'
hint: Updates were rejected because the remote contains work that you do not
hint: have locally. This is usually caused by another repository pushing to
hint: the same ref. If you want to integrate the remote changes, use
hint: 'git pull' before pushing again.

Сначала заберите чужие изменения, потом отправляйте свои. Если обе копии изменились, простой git pull попросит выбрать способ объединения:

fatal: Need to specify how to reconcile divergent branches.

Новичку проще всего слияние: git pull --no-rebase, затем git push. Чтобы не писать ключ каждый раз, выполните git config --global pull.rebase false.

Что не коммитить

Пароли, токены, ключи. Удалить файл из следующего коммита мало. Он остаётся в истории:

$ git rm --cached .env
$ git commit -m "Убрал .env из репозитория"
$ git show HEAD~1:.env
DB_PASSWORD=qwerty123

git rm --cached убирает файл из репозитория, но оставляет его на диске. Добавьте .env в .gitignore. Если пароль уже попал на GitHub, считайте его раскрытым и смените.

Большие файлы. Git хранит все версии каждого файла, и репозиторий быстро раздувается. GitHub предупреждает о файлах больше 50 МиБ и не принимает файлы больше 100 МиБ (документация). Наборы данных, видео и собранные программы держите вне репозитория, а в README напишите, где их взять.

Частые ошибки

Сообщение Что значит Что делать
not a git repository вы не в папке репозитория cd в папку проекта
Author identity unknown Git не знает автора git config --global user.name и user.email
nothing added to commit but untracked files present забыли git add git add <файл>, затем git commit
src refspec main does not match any нет ни одного коммита или ветка называется master сделайте коммит, проверьте имя ветки в git branch
rejected ... (fetch first) на сервере есть чужие коммиты git pull --no-rebase, затем git push

Как с этим помогает Tilpi

Если не понимаете, что поменялось между версиями, вставьте вывод git diff в чат задания: он объясняет код и разберёт правку по строкам. Перед отправкой готовой версии её можно проверить исполнителем: он соберёт и запустит код в отдельной изолированной машине, прогонит тесты и соберёт отчёт о проверке в Word и PDF. Исполнитель входит во все тарифы: в «Лайт» и «Стандарт» на уровне «Быстрая», в «Плюс» на всех уровнях, а без тарифа работает на «Быстрой» из бесплатных ежемесячных кредитов, общих с чатом.

Запустим ваш код. Даже с телефона.

ИИ-исполнитель соберёт программу в отдельной машине, запустит её и пришлёт вывод и файлы. Ставить компилятор не нужно.

Проверить готовую версию в Tilpi