Перейти к содержимому

СофтРазбор

Как отменить git add и сохранить изменения в файле

git restore —staged меняет индекс и оставляет рабочий файл. Разбираем выбор источника на примере с двумя разными версиями правок.

Иллюстрация: Как отменить git add и сохранить изменения в файле
Содержание3 разделов

Чтобы убрать изменённый файл из подготовленного коммита и оставить его правки на диске, в Git есть git restore --staged. Этот флаг меняет индекс. Команда restore без него по умолчанию меняет рабочую копию и может перезаписать незакоммиченные правки.

Инструкция по документации Git, проверенной 12 октября 2026 года. Запишите git --version. Ниже нужен обычный репозиторий с существующим HEAD, то есть хотя бы одним коммитом, без незавершённого конфликта. Перед изменением сохраните отдельную копию нужного файла за пределами репозитория.

Проверьте путь и уберите только его

Из корня своего репозитория сначала посмотрите, что подготовлено. note.txt замените точным путём файла; не подставляйте точку для всего проекта:

git diff --staged -- note.txt
git diff -- note.txt
git status --short -- note.txt

Если этот файл нужно исключить из индекса, выполните:

git restore --staged -- note.txt

Без явного source команда с флагом staged берёт содержимое из HEAD. Рабочая копия остаётся на диске. Для обычного изменённого отслеживаемого файла повторный git diff --staged -- note.txt должен стать пустым, а обычный diff показать оставленные правки.

Что будет с двумя версиями одного файла

Учебный пример в отдельном временном репозитории: в последнем коммите note.txt содержит строку alpha. Её заменили на beta и выполнили git add. Затем на диске поменяли beta на gamma без нового add.

До restore индекс хранит beta, рабочий файл содержит gamma. После git restore --staged -- note.txt индекс снова содержит alpha, а рабочий файл по-прежнему gamma. Поэтому обычный diff показывает переход alpha → gamma. Подготовленная версия beta больше не стоит в очереди на коммит. Если она нужна отдельно, сохраните её до команды; копия рабочего файла в этом примере содержит только gamma.

Для сравнения, restore без staged взял бы beta из индекса и записал её поверх gamma на диске. Это другой результат, поэтому флаг проверяют до запуска. Сравнения рабочей копии и индекса подробнее показаны в разборе пустого git diff.

Когда ожидаемый результат отличается

У нового файла, добавленного после последнего коммита, нет версии в HEAD. После снятия с индекса он остаётся на диске как неотслеживаемый; найдите его через status. Обычный diff такой файл не показывает. Если первого коммита ещё нет, пример с источником HEAD неприменим: не повторяйте команду, не разобрав это состояние.

Снятие с индекса само по себе не удаляет файл из уже существующей истории и не скрывает ранее опубликованный секрет. Для файлов, которые снова попадают в add, отдельно проверьте правила .gitignore и отслеживание.

Обложка создана нейросетью как иллюстрация темы; она не воспроизводит реальный интерфейс программы.

Если изменение уже закоммичено локально, снятие файла с индекса решает другую задачу. Есть отдельный порядок, как отменить последний непереданный коммит и оставить его правки.

Источники

Птичка messgo спрашивает, как вам материал

Как вам материал?

Поделиться

Читайте также

Комментарии

Написать комментарий

Без регистрации: имя и почта не нужны, мы подпишем вас случайным именем. Комментарий появится после проверки редакцией.