Что такое незакомиченное изменение?

Что такое незакомиченное изменение?

Незакомиченное изменение (Uncommitted Changes) — это изменения в исходном коде или файлах проекта, которые были созданы или отредактированы, но ещё не добавлены в систему контроля версий (обычно Git) через commit.

Другими словами: вы отредактировали файлы, но они ещё не сохранены в истории проекта.

Состояния файлов в Git

В Git каждый файл может быть в одном из состояний:

                  Working Directory
                         ↓
                   (Untracked / Modified)
                         ↓
     git add → Staging Area (Index)
                         ↓
    git commit → Git Repository
                     (History)

Типы незакомиченных изменений

1. Untracked Files (неотслеживаемые файлы)

Новые файлы, которые никогда не были добавлены в Git:

# Создаём новый файл
echo "Hello" > myfile.txt

# Проверяем статус
git status

# Вывод:
# Untracked files:
#   myfile.txt

Эти файлы Git не отслеживает вообще.

2. Modified (изменённые файлы)

Файлы, которые уже в Git, но были отредактированы:

# Редактируем файл
echo "New content" >> README.md

# Статус
git status

# Вывод:
# Changes not staged for commit:
#   modified: README.md

Такой файл был когда-то закомичен, но сейчас имеет изменения в рабочей директории.

3. Staged changes (изменения в stage area)

Изменения добавлены в staging area через git add, но ещё не закомичены:

# Редактируем и добавляем в staging
echo "Content" >> file.txt
git add file.txt

# Статус
git status

# Вывод:
# Changes to be committed:
#   new file: file.txt

Эти изменения станут частью следующего commit.

Визуализация состояний

1. Создаём новый файл config.json
   Status: untracked
   
2. git add config.json
   Status: staged (Changes to be committed)
   
3. git commit -m "Add config"
   Status: committed (в истории)
   
4. Редактируем config.json
   Status: modified (в Working Directory)
   
5. git add config.json
   Status: staged снова
   
6. git commit -m "Update config"
   Status: committed опять

Просмотр незакомиченных изменений

Какие файлы изменены:

git status

# Вывод:
# On branch main
# 
# Untracked files:
#   (use "git add <file>..." to include in what will be committed)
#   newfile.java
# 
# Changes not staged for commit:
#   (use "git add <file>..." to update what will be committed)
#   modified: src/Main.java
#   deleted: old.txt
# 
# Changes to be committed:
#   (use "git restore --staged <file>..." to unstage)
#   new file: config.xml

Что именно изменилось в файлах:

# Изменения в Working Directory (не staged)
git diff

# Вывод diff: старая версия vs текущая
# - удалённые строки
# + добавленные строки

# Изменения в Staging Area
git diff --staged

# Изменения относительно commit
git diff HEAD

Примеры

Пример 1: Забыли добавить все файлы

# Редактируем несколько файлов
echo "Change 1" >> src/Service.java
echo "Change 2" >> src/Model.java
echo "Change 3" >> tests/ServiceTest.java

# Добавляем только некоторые
git add src/Service.java

# Статус показывает неполный commit
git status
# Changes to be committed:
#   modified: src/Service.java
# 
# Changes not staged for commit:
#   modified: src/Model.java
#   modified: tests/ServiceTest.java

Если закомитить сейчас, только Service.java попадёт в commit.

Пример 2: Создали временные файлы

# Создали временные файлы для тестирования
echo "temp" > temp_debug.txt
echo "test" > test.log

git status
# Untracked files:
#   temp_debug.txt
#   test.log

# Нужно добавить в .gitignore перед commit
echo "temp_debug.txt" >> .gitignore
echo "test.log" >> .gitignore
git add .gitignore
git commit -m "Add .gitignore"

Как работать с незакомиченными изменениями

1. Просмотр изменений

# Все незакомиченные
git status

# Детальное сравнение
git diff

# С синтаксисом языка
git diff --color-words

2. Добавление в staging area

# Добавить конкретный файл
git add file.java

# Добавить все изменения
git add .

# Интерактивное добавление (выбрать куски кода)
git add -p

# Добавить всё кроме новых файлов
git add -u

3. Отмена изменений

# Отменить изменения в файле (вернуть из последнего commit)
git checkout -- file.java

# Или в новом Git
git restore file.java

# Отменить все changes
git reset --hard HEAD

4. Очистка незакомиченных файлов

# Удалить untracked файлы (ОСТОРОЖНО!)
git clean -fd

# Сухой запуск (показать что удалится)
git clean -fd --dry-run

5. Сохранение временных изменений (Stash)

# Сохранить незакомиченные изменения
git stash

# Working directory чистый, можно переключаться на ветку
git checkout other-branch

# Позже восстановить
git stash pop

Частые проблемы

Проблема 1: Забыли добавить файлы

# Я отредактировал файлы, но забыл их staged
git status
# Changes not staged for commit:
#   modified: file1.java
#   modified: file2.java

# Нужно добавить перед commit
git add file1.java file2.java
git commit -m "Fix bugs"

Проблема 2: Случайно добавил мусор

# Добавил, но ещё не закомитил
git status
# Changes to be committed:
#   new file: debug.txt
#   new file: temp.log

# Убрать из staging
git reset HEAD debug.txt
git reset HEAD temp.log

# Удалить файлы
rm debug.txt temp.log

Проблема 3: Нужно переключиться на другую ветку

# Изменения есть, но они не закомичены
git status
# Changes not staged for commit:
#   modified: src/Main.java

# Нельзя переключиться на другую ветку
git checkout feature
# error: Your local changes to 'src/Main.java' would be overwritten by checkout

# Решение 1: Закомить изменения
git add src/Main.java
git commit -m "WIP: work in progress"
git checkout feature

# Решение 2: Сохранить временно
git stash
git checkout feature
# потом:
git stash pop

Best Practices

1. Часто коммитить

# Лучше: частые маленькие commits
git add feature-part-1.java
git commit -m "Implement feature part 1"

git add feature-part-2.java
git commit -m "Implement feature part 2"

# Чем: один большой commit с кучей файлов

2. Проверить перед commit

# Всегда проверяй что коммитится
git diff --staged  # Что в staging

# Можно сделать это красивым способом
git status

# Коммить только осознанно
git commit -m "Feature: implement authentication"

3. Использовать .gitignore

# .gitignore
*.class
*.log
/target/
node_modules/
.env
.DS_Store

Тогда эти файлы не будут появляться как untracked.

4. Не добавлять мусор

# ❌ Плохо
git add .  # Может добавить всё, включая мусор

# ✅ Хорошо
git add src/
git add tests/
git add pom.xml
git add README.md

Заключение

Незакомиченные изменения — это естественная часть разработки. Важно понимать состояния файлов (untracked, modified, staged) и уметь с ними работать. Ключевые операции:

• git status — посмотреть что изменилось
• git add — добавить в staging для commit
• git diff — посмотреть содержание изменений
• git restore — отменить изменения
• git stash — сохранить временно