Git stash push 怎么只暂存某个目录

如果只想把某个目录的修改先收起来，关键写法是把路径放在双横线后面：git stash push -m "save docs" -- docs/。这里的 docs/ 是 pathspec，Git 只把匹配路径的已跟踪修改写入新的 stash，其他目录继续留在工作区。

官方地址：https://git-scm.com/docs/git-stash

不要把目录直接接在消息参数后面，也不要省略 --。先用 git status --short 看清范围，再用 git stash show -p stash@{0} 核对 stash 里是否只有目标目录。

步骤一：先确认目标目录和工作区状态

进入仓库根目录，先确认目录名和当前分支。假设工作区同时改了 docs/、src/，并且 docs/guide.md 还有一个未跟踪文件，可以先执行：

# 查看短格式状态，先区分目标目录和其他路径
git status --short

# 确认当前所在仓库和分支，避免在错误目录操作
git rev-parse --show-toplevel
git branch --show-current

状态里的 M docs/guide.md 属于已跟踪修改，?? docs/draft.md 属于未跟踪文件。默认的 stash push 不会自动收走后者，后面要单独决定是否加 -u。

步骤二：使用 git stash push 的路径参数

在 Git 工作台的命令面板中选择“工作区 → Stash → 按路径保存”，确认 pathspec 字段为 docs/，或直接在仓库根目录执行命令。消息只是便于识别，真正限制范围的是双横线后的路径：

# 只保存 docs/ 下已经被 Git 跟踪的修改
git stash push -m "save docs changes" -- docs/

命令成功后，docs/ 中匹配的已跟踪修改会回到 HEAD 状态；src/ 和其他不匹配路径的修改仍留在工作区。这正是目录级 stash 与无参数 git stash 的区别。

步骤三：处理未跟踪文件和已暂存文件

目录筛选和文件是否被跟踪是两件事。需要把 docs/ 内的未跟踪文件也收进 stash 时，加上 -u；已经暂存的内容想继续留在索引中，则加上 --keep-index：

# 目标目录的已跟踪修改和未跟踪文件一起保存
git stash push -u -m "save docs including new files" -- docs/

# 保存其他未暂存修改，但保留当前 index 中已经暂存的内容
git stash push --keep-index -m "save unstaged docs" -- docs/

如果目录名很多或包含换行、特殊字符，可以改用 --pathspec-from-file，让 Git 从文件读取路径；普通单目录场景直接使用 -- docs/ 更容易复核。

步骤四：查看 stash 内容并安全恢复

不要只看命令返回成功就继续工作。先列出条目，再检查最新 stash 的补丁路径：

# 查看最新 stash 的概要和完整补丁
git stash list
git stash show -p stash@{0}

# 先恢复但保留 stash，确认无误后再决定是否删除
git stash apply stash@{0}

# 需要恢复并在成功应用后移除该条目时使用 pop
git stash pop stash@{0}

如果补丁预览里出现了 src/ 等不匹配目录，先不要执行 pop，检查是否引用了旧的 stash@{1}，或是在命令中误把路径写在了双横线之前。apply 发生冲突时 stash 会保留，处理冲突后可以再次查看；这也是初次核对时更稳妥的选择。

常见问题

为什么写了目录，其他目录的修改也被收走了？

最常见原因是漏写 --，或实际运行的是没有 pathspec 的 git stash。按 git stash push -m "说明" -- docs/ 重试，并用 git stash show -p 核对。

目录里的新文件为什么还在？

未跟踪文件默认不进入 stash。需要它们一起保存时使用 -u，再用 git status --short 确认。

apply 和 pop 应该选哪个？

第一次恢复或需要保留备份时选 apply；确认应用结果且不再需要该 stash 时再用 pop。出现冲突时不要急着删除条目。