Базовые команды Git: init, status, add, commit, log

Что мы изучим?#

Ежедневный рабочий цикл с Git, команда за командой:

И дополнительно: .gitignore — как сказать Git «игнорируй это».

Зачем это нужно?#

Это команды, которые разработчики выполняют десятки раз в день. Отныне каждое упражнение и каждый проект курса будут вестись в Git: во-первых, потому что это профессиональная привычка, а во-вторых, потому что в проектах ООП и в интеграционном проекте история спасёт вас, когда что-то сломается.

Объяснение с основ#

Рабочий цикл#

1. edit files          (Working Directory changes)
2. git status          (see what changed)
3. git add <files>     (choose what goes into the snapshot)
4. git commit -m "..." (save the snapshot)
5. repeat

git status — самая важная команда#

git status ничего не меняет. Она только сообщает состояние: что Untracked, что Modified, что Staged. Золотое правило: перед каждым add и перед каждым commit выполняйте git status.

Сообщение Commit#

Сообщение объясняет, что изменилось и зачем, для того, кто будет читать историю (включая вас через месяц). Подробнее о правилах — в следующем уроке. Пока: короткое предложение на английском в повелительном наклонении: "Add discount calculation", "Fix crash on empty cart".

.gitignore#

Не каждый файл должен попасть в репозиторий:

• Файлы, которые создаются автоматически: __pycache__/, *.pyc.
• Личная или секретная информация: пароли, ключи API, файлы .env. Они не должны попасть на GitHub!
• Локальные рабочие файлы: логи (*.log), локальная база данных, виртуальные окружения (venv/, мы встретим их в темах бэкенда и баз данных).
• Системные файлы: .DS_Store (Mac), Thumbs.db (Windows).

Файл с именем .gitignore в папке проекта содержит шаблоны (по одному на строку), и Git просто не «видит» соответствующие им файлы.

Синтаксис#

git init                          # create a repository in the current folder
git status                        # show the state of files
git add file.py                   # stage one file
git add folder/                   # stage everything in a folder
git add .                         # stage ALL changes in the current folder (check status first!)
git commit -m "Short message"     # commit staged changes with a message
git log                           # full history (press q to quit)
git log --oneline                 # compact history, one line per commit
git diff                          # changes NOT yet staged
git diff --staged                 # changes that ARE staged (will go into the commit)
git restore --staged file.py      # un-stage a file (keeps your edits)

Пример .gitignore для проекта на Python:

# Python cache
__pycache__/
*.pyc

# Local data and logs
*.log
*.db

# Secrets and environments
.env
venv/

# OS files
.DS_Store
Thumbs.db

# = комментарий. * = «что угодно». Строка, которая заканчивается на /, = папка.

Первый пример кода#

Полный рабочий цикл с нуля. Внутри kodkod6:

mkdir calculator
cd calculator
git init

Создайте calculator.py:

def add(a, b):
    return a + b

А теперь:

git status
git add calculator.py
git status
git commit -m "Add calculator with add function"
git log --oneline

Вывод:

On branch main

No commits yet

Untracked files:
  (use "git add <file>..." to include in what will be committed)
        calculator.py

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

On branch main

No commits yet

Changes to be committed:
  (use "git rm --cached <file>..." to unstage)
        new file:   calculator.py

[main (root-commit) 4e7a1c2] Add calculator with add function
 1 file changed, 2 insertions(+)
 create mode 100644 calculator.py

4e7a1c2 (HEAD -> main) Add calculator with add function

Разбор кода построчно#

Обратите внимание: git status сам подсказывает, что делать (use "git add <file>..."). Читайте его подсказки!

Ещё один пример#

Изменение, diff и второй Commit. Добавьте в calculator.py:

def subtract(a, b):
    return a - b

git status
git diff
git add calculator.py
git commit -m "Add subtract function"
git log

git status:

Changes not staged for commit:
        modified:   calculator.py

git diff:

diff --git a/calculator.py b/calculator.py
--- a/calculator.py
+++ b/calculator.py
@@ -1,2 +1,6 @@
 def add(a, b):
     return a + b
+
+
+def subtract(a, b):
+    return a - b

git log:

commit 9d02b6f5e1a8c7d3b4f2e6a9c0d1e8b7f6a5c4d3 (HEAD -> main)
Author: Dana Cohen <dana@example.com>
Date:   Tue Oct 6 11:20:41 2026 +0300

    Add subtract function

commit 4e7a1c2b8f0d6e5a3c1b9d7f4e2a0c8b6d5f3e1a
Author: Dana Cohen <dana@example.com>
Date:   Tue Oct 6 11:05:12 2026 +0300

    Add calculator with add function

Разбор:

• modified: — файл известен Git (он был в Commit), и он изменился.
• В git diff строка, которая начинается с +, добавлена, строка с - удалена, а строка с пробелом — неизменный контекст. @@ -1,2 +1,6 @@ = «строки 1–2 старой версии стали строками 1–6 новой».
• git log показывает от новых к старым: полный Hash, автора, дату и сообщение. Чтобы выйти из длинного git log: клавиша q.

А теперь .gitignore: запустите код один раз (python -c "import calculator"), и git status покажет __pycache__/ как Untracked. Создайте .gitignore с __pycache__/, и git status перестанет его показывать. Не забудьте: git add .gitignore и Commit. Сам этот файл должен быть в репозитории.

Типичная ошибка#

Ошибка 1: git add . без проверки status. add . добавляет всё, включая логи, __pycache__ и, хуже всего, файлы с паролями. Сначала git status, сначала .gitignore, и только потом add ..

А если вы по ошибке добавили что-то в Staging:

git restore --staged secrets.txt

Файл уходит из Staging, а изменения в нём остаются.

Ошибка 2: Commit без -m. Один git commit открывает текстовый редактор для сообщения. Если вы не настроили core.editor, обычно откроется Vim — редактор, из которого «трудно выйти». Если вы застряли в Vim: Esc, затем наберите :q! и Enter (выйти без сохранения), а потом запустите снова с -m "...".

Ошибка 3: бессмысленные сообщения.

a1b2c3d fix
e4f5a6b stuff
c7d8e9f asdf
f0a1b2c final

Через месяц никто не поймёт, что происходило в этой истории. Каждый Commit — «письмо в будущее».

Ошибка 4: добавить в .gitignore файл, который уже был закоммичен. .gitignore действует только на файлы, которые Git ещё не отслеживает. Если app.log уже в репозитории, нужно ещё и прекратить его отслеживать: git rm --cached app.log, а затем Commit.

Практика#

Упражнения опираются только на то, что пройдено в этом уроке и в предыдущих. Сначала попробуйте сами, и только потом открывайте решение.

Упражнение 1: Первый Commit#

В новой папке есть файл calculator.py. Напишите последовательность команд, которая создаёт репозиторий, проверяет состояние, добавляет файл и делает первый Commit с подходящим сообщением.

git init
git status
git add calculator.py
git commit -m "Add calculator with add and subtract"
git status

Упражнение 2: Читаем git status#

Changes to be committed:
        modified:   calculator.py

Changes not staged for commit:
        modified:   README.md

Untracked files:
        notes.txt

Для каждого файла — в каком он состоянии и что с ним будет, если сейчас выполнить git commit -m "Update"?

Упражнение 3: .gitignore#

В проекте на Python есть:

main.py
calculator.py
__pycache__/
secrets.txt        (passwords)
app.log
README.md

Напишите подходящий файл .gitignore и объясните, зачем в нём каждая строка.

# Python cache
__pycache__/
*.pyc

# Passwords and keys
secrets.txt

# Logs
*.log

Упражнение 4: Читаем git diff#

-def add(a, b):
-    return a - b
+def add(a, b):
+    return a + b

1. Что означают строки, которые начинаются с - и +?
2. В чём фактическое изменение и какое сообщение Commit ему подходит?

Упражнение 5: История с git log#

e91d5aa Fix VAT rounding
7b2e004 Add price calculator
a3f9c21 Initial project

1. Какая команда показывает историю по одной строке на Commit?
2. Какой Commit самый старый, а какой последний?
3. Добавьте функцию multiply, а затем divide. Сколько Commit вы бы сделали и почему?

Итоги#

• Цикл: редактирование → git status → git add → git commit -m "...".
• git status = «каково состояние?». Выполняйте перед каждым действием и читайте подсказки.
• git log --oneline = история. git diff = что изменилось (--staged = что войдёт в Commit).
• git add . — только после status и .gitignore. git restore --staged выводит файл из Staging.
• .gitignore: __pycache__/, логи, .env, секреты. Сам он входит в репозиторий.

Официальная документация#

• Pro Git — Getting a Git Repository
• Pro Git — Recording Changes
• Pro Git — Viewing the Commit History