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

СофтРазбор

Git stash не убрал новый файл: когда нужен include-untracked

Обычный stash и сохранение с -u охватывают разные файлы. Проверяем состав снимка до переключения задачи.

Иллюстрация: Git stash не убрал новый файл: когда нужен include-untracked
Содержание2 разделов

После git stash push новый файл может остаться в рабочей папке. Для ещё не отслеживаемых файлов нужен параметр -u, он же --include-untracked. Игнорируемые файлы этим параметром не захватываются.

Ниже учебный опыт для терминала macOS или Linux. Он создаёт отдельную папку; в рабочем проекте его запускать не нужно. Документация проверена 19 октября 2026 года. Версию покажет git --version. Учебная последовательность ниже выполнена на Git 2.50.1 (Apple Git-155); полученные имена файлов совпали с описанием.

Сравните два снимка на одном наборе

Имя папки должно быть свободно. Если mkdir сообщил, что она существует, остановитесь и выберите другое имя. Команды создания выполняйте в указанном порядке, переходя дальше только после успеха предыдущей.

mkdir messgo-stash-demo
cd messgo-stash-demo
git init
git config user.name "Messgo Demo"
git config user.email "demo@example.invalid"
printf 'base\n' > tracked.txt
git add tracked.txt
git -c commit.gpgsign=false commit -m "base"
printf 'change\n' >> tracked.txt
printf 'new\n' > draft.txt
printf 'cache.tmp\n' > .gitignore
printf 'temporary\n' > cache.tmp

В наборе есть изменённый отслеживаемый tracked.txt, новый draft.txt и игнорируемый cache.tmp. Сам .gitignore тоже пока новый. Настройки имени и почты записываются только в учебный репозиторий.

git stash push -m "tracked only"
git status --short
git stash show --include-untracked --name-only 'stash@{0}'

В status останутся ?? .gitignore и ?? draft.txt. В составе первого снимка будет tracked.txt. Файл cache.tmp остаётся на диске, но правило исключает его из обычного status.

Теперь сохраните оставшиеся новые файлы:

git stash push -u -m "new files"
git status --short
git stash show --include-untracked --name-only 'stash@{0}'
git stash list

Второй снимок содержит .gitignore и draft.txt. После него cache.tmp может появиться как ?? cache.tmp: правило .gitignore тоже убрано в stash, а игнорируемый файл остался. Это полезная контрольная деталь, по которой видно отличие снимка от копии всей папки.

Сначала восстановите, затем решайте судьбу снимка

git stash apply 'stash@{0}'
git status --short
git stash list

Здесь вернутся новые файлы и правило игнорирования. Обе записи stash сохранятся. Изменение tracked.txt лежит в более ранней записи stash@{1}; при необходимости её смотрят и применяют отдельно. Номер зависит от текущего списка.

Команда apply сохраняет запись, а pop при успешном применении удаляет её из списка. В рабочем проекте перед применением проверьте состояние файлов: возможны конфликты. Не добавляйте -a автоматически ради чистого status: этот режим включает и игнорируемые файлы.

Состав будущего коммита проверяйте через staged diff. Почему правило не действует на уже отслеживаемый файл, объясняет разбор .gitignore.

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

Источники

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

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

Поделиться

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

Комментарии

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

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