文档教程知识库【免费下载链接】til:memo: Today I Learned项目地址https://gitcode.com/gh_mirrors/ti/til点击查看免费下载git stash是 Git 中把工作区临时收起来的核心命令而-p--patch参数让它从全量暂存升级为逐块挑选。本文以 til 仓库中 staging-stashes-interactively.md 为主线结合仓库内多篇 git 实践文档系统讲解git stash -p的使用场景、交互选项、与其他 stash 参数的组合限制以及配套的查看、恢复与清理技巧帮助你像精修git add -p一样精细控制每次 stash 的内容。为什么需要交互式暂存patch 模式默认情况下git stash会把工作区中所有已跟踪文件的改动整体暂存起来一次性清空工作区。但现实中经常遇到这样的场景你同时改了两处代码一处是临时实验、想先放一边另一处还没写完、想继续工作。此时如果直接git stash会把两处改动一起收走无法继续写第二处。git stash -p正是为此设计的它把暂存什么的决定权交还给你逐块hunk询问是否要收入 stash与git add -p交互式暂存stage的思路完全一致。正如 staging-stashes-interactively.md 所述-p标志可以像用于git add一样用于git stash从而实现交互式地选择要暂存的内容。基本用法git stash -p当工作区同时存在想暂存和想继续保留的改动时直接执行git stash -p命令会进入交互式界面git 依次展示工作区与 HEAD 之间的每一处差异块并等待你对每个块做出决定。这一行为与 pick-specific-changes-to-stash.md 中介绍的git stash --patch完全等价-p是其短选项形式$ git stash --patch使用--patch时你可以从 HEAD 与工作区之间的 diff 中交互式地选择 hunk 加入 stash。交互界面中的选项y / n / a / d进入交互模式后每个 hunk 都会被呈现出来并附带一组选项。最基础的两个是y—— yes把这个 hunk 收进 stashn—— no跳过这个 hunk保留在工作区。仅靠这两个按键逐块确认遇到改动量大时效率不高。仓库中 include-or-exclude-remaining-patch-changes.md 补充了两个高频快捷键在交互式暂存staging与交互式 stash 中通用a - stage this hunk and all later hunks in the file d - do not stage this hunk or any of the later hunks in the file按a接收当前块及当前文件中之后的所有块。适合处理yarn.lock这类机器生成、改动量巨大且你全都要收走的文件省去连续按十几次y。按d拒绝当前块及当前文件中之后的所有块。适合处理schema.rb这类包含大量不想入库的客户端差异、但你又希望快速跳过的文件免去连续按十几次n。除了上述选项交互模式还支持更多高级指令完整的键位说明可在git-add手册的Interactive mode交互模式章节中查阅运行man git-add。也正因为这套选项体系与git add -p共用你已有的交互式暂存操作习惯可以直接迁移到 stash 场景。与其他 stash 参数的组合与限制交互式 stash 并非与所有 stash 参数都能自由搭配仓库中 stash-a-single-untracked-file.md 记录了一个典型限制-u--include-untracked收纳未跟踪文件与-p无法同时使用$ git stash -u -p Cant use --patch and --include-untracked or --all at the same time原因是 patch 交互模式基于已跟踪文件的工作区与 HEAD 差异逐块挑选而--include-untracked/--all引入的未跟踪、被忽略文件没有对应的 diff 块可供逐块选择git 因此直接拒绝组合。当你想只暂存某个指定的未跟踪文件时可以用路径限定方式绕过这一限制$ git stash -u -- name-of-untracked-file这条命令只会把指定的未跟踪文件收进 stash其余未跟踪文件保持原样。仓库中记录的实践场景是测试一个新库的安装配置时多出来的某个临时新文件会被 stash 暂时移出视野、又不至于丢失等需要时再取回。至于已跟踪文件的全量 stashstashing-untracked-files.md 和 stash-everything.md 说明了git stash默认只处理已跟踪文件、git stash -u追加未跟踪文件、git stash --all则连被忽略文件如node_modules也一并收纳——后者通常要谨慎使用。而 stashing-only-unstaged-changes.md 展示了另一条互补路径用git stash -k--keep-index只暂存未暂存的改动已git add的内容保留在索引中待提交$ git stash -k Saved working directory and index state ...记录、查看、恢复与清理stash 的完整闭环交互式 stash 只是第一步后续还需要围绕 stash 条目做管理仓库中有多篇文档覆盖这些环节记录默认 stash 条目标识会带上分支名与最近提交信息include-a-message-with-your-stashed-changes.md 建议用git stash push -m some context自定义描述避免隔几天后对着WIP on master: 6766419 ...想不起内容$ git stash push -m made some changes $ git stash list stash{0}: On master: made some changes查看git stash list列出全部 stash 条目show-what-is-in-a-stash.md 介绍了两种查看方式——既可用通用的git show stash{0}查看指定 ref也可用内置的git stash show 1省略数字时默认展示最新的stash{0}免去敲写 ref 的繁琐。恢复git stash pop应用最近一条 stash 并将其从列表中移除也可对指定条目执行这是 stash 工作流的常规出口。清理当某些 stash 被长期遗忘、不再需要时clear-entries-from-git-stash.md 提供了两种手段——单条用git stash drop stash{0}全部清空用git stash clear执行后git stash list即为空。更精细的配套交互式撤暂存交互式思路在 Git 中贯穿多个命令仓库的 interactively-unstage-changes.md 展示了它的反向用法——git reset --patch逐块撤出索引中的内容。如果你已经用git add -p暂存了部分改动、又后悔其中几块不必全量 reset$ git reset --patch README.md # 只针对单个文件 $ git reset --patch # 作用于整个仓库这与git stash -p共享同一套交互机制方向相反理解其一即可触类旁通。若你习惯在 vim 中工作staging-changes-within-vim.md 还提到在 fugitive 的:Gstatus中对文件按p同样可以直接进入该文件的交互式暂存模式。小结git stash -p把交互式暂存能力引入 stash 流程让你在全部收走和完全不动之间获得逐块级的精细控制先y/n决定每个 hunk 的去留再用a/d批量处理机器生成的大文件。使用时需记住它与-u/--all互斥单文件未跟踪场景可改用git stash -u -- file达成目的。配合-k、-m、git stash show、git stash pop与git stash clear即可构建一套从暂存、记录、恢复到清理的完整闭环更多细节可查阅man git-stash。赞分享文档教程知识库【免费下载链接】til:memo: Today I Learned项目地址https://gitcode.com/gh_mirrors/ti/til点击查看免费下载相关推荐30 seconds of code Git 篇Git stash 暂存机制完整操作指南30 seconds of code Git 篇Git stash 暂存机制完整操作指南 Git 的暂存stashing功能允许你把工作目录中尚未提交的本教程文档如何快速解决AlphaFold 3蛋白质结构预测的5个常见运行问题如何快速解决AlphaFold 3蛋白质结构预测的5个常见运行问题 AlphaFold 3作为当前最先进的蛋白质结构预测工具在运行过程中你可能会遇到各种配置和人工智能基础模型深度学习生物信息学科学计算VSCode-GitLens暂存功能终极指南Stash类与暂存数据管理详解VSCode GitLens暂存功能终极指南Stash类与暂存数据管理详解 VSCode GitLens作为一款强大的Git扩展在VS Code中提供了前所开发工具版本控制上一篇Area51跨平台网络PC与控制台联机方案设计下一篇Awesome Agent Skills 架构构建企业级AI智能体生态的技术范式创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考