УРОК · Git перед первым проектом

Проверка изменений и первый коммит

Опубликовано Автор: Соловьёва Мария Андреевна

Правила исключения уже проверены. Теперь подготовим код и прочитаем состав первого коммита до сохранения истории.

Разберём по шагам

В прошлом уроке git status показал исходники как новые, а три базы SQLite скрыл. Теперь выберем файлы для коммита. Git сначала помещает их в индекс — список следующего снимка, который можно проверить и исправить. После проверки git commit сохранит выбранное в истории; локальные файлы базы останутся на месте.

Слова, которые пригодятся

Индекс
Набор файлов и изменений, выбранных для следующего коммита. После git add . команда git diff --cached показывает именно его содержимое.
Diff
Сравнение содержимого файлов. Обычный git diff показывает неподготовленные изменения уже отслеживаемых файлов; git diff --cached показывает подготовленное к коммиту.
Коммит
Сохранённый в истории снимок индекса с сообщением и автором. git log -1 --oneline позволяет увидеть его после записи.

git status показывает новые и подготовленные файлы. Обычный git diff до первого git add не показывает содержимое новых файлов, потому что они ещё не отслеживаются. git add . из корня готовит все неигнорируемые файлы; правило .gitignore покрывает названные пути, но другой файл с секретом всё ещё может попасть в индекс. Поэтому просмотрите полный git diff --cached перед коммитом.

Если Git остановит коммит сообщением Author identity unknown, задайте имя и почту только для notes-php: git config --local user.name "Ваше имя" и git config --local user.email "ваш-адрес@example.com". Подставьте свои данные: они попадут в историю коммитов. После этого повторите git commit. Файл, снятый командой git rm --cached -- путь-к-файлу, остаётся на диске и появляется в git status как неотслеживаемый. В чистой копии после клонирования папки data не будет: Git не хранит пустые папки и исключил SQLite-файлы, поэтому README должен восстановить подготовку базы.

Что проверить перед коммитом
Команда Что показывает
git status Новые, изменённые и подготовленные файлы
git diff Неподготовленные изменения уже отслеживаемых файлов
git diff —cached Содержимое следующего коммита

Рабочий пример

git status
git add .
git diff --cached --stat
git diff --cached
git status

Что здесь происходит

  • git add . выполняйте только из корня notes-php после проверки .gitignore.
  • git diff --cached --stat показывает имена и объём, а полный git diff --cached позволяет заметить пароль или лишнюю правку.
  • Если индекс не тот, исправьте его до git commit; локальную базу не удаляйте ради чистого git status.

Практика

Соберите первый проверенный снимок кода: README поможет открыть проект из чистой копии, а просмотр индекса предотвратит случайное сохранение локальных данных.

  1. В Visual Studio Code в корне notes-php создайте README.md рядом с .gitignore и сохраните Ctrl+S. Запишите заголовок «Каталог заметок», пояснение «Локальный учебный проект без входа», а ниже порядок для чистой копии: mkdir data, php setup.php, один запуск php add-note.php для учебной строки, php migrate-created-at.php для схемы после SQLite4, затем php -S localhost:8000 -t public. Поясните, что на уже заполненной базе add-note.php каждый раз добавит новую строку.
  2. Из корня notes-php выполните пять команд из примера. Просмотрите не только имена в git diff --cached --stat, но и полный git diff --cached: там должны быть README.md, .gitignore, public/index.php, src/default-notes.php и четыре CLI-скрипта. Трёх файлов data/*.sqlite, .env, .env.local и других секретов в индексе быть не должно.
  3. Если подготовили лишний новый файл, снимите его с индекса командой git rm --cached -- путь-к-файлу, подставив его имя. Файл останется на диске как неотслеживаемый; повторите git diff --cached и решите, где хранить этот файл. Затем выполните git commit -m "Сохранить учебный каталог", git status и git log -1 --oneline. В чистом учебном маршруте git status после коммита не показывает новых изменений.

Как проверить себя

В git log -1 --oneline виден первый коммит, а git status не показывает подготовленных изменений. В составе коммита есть инструкции для чистой копии, но нет файлов SQLite и локальных настроек.

Если не получилось
  • git diff пуст при новом README.md? Посмотрите git status, затем git add README.md и git diff --cached.
  • Git просит user.name и user.email? Задайте их для этого репозитория командами выше и повторите коммит; данные автора будут записаны в историю.

Куда заглянуть дальше