IDEA（十五） IDEA 开发必备：Git Shelve Changes 与 Stash Changes 详解

目录1. 为什么需要「暂存」本地改动2. 入口在哪里3. Shelve Changes 详解3.1 什么是 Shelve3.2 搁置操作步骤3.3 查看与恢复Unshelve3.4 Shelve 的特点易踩坑4. Stash Changes 详解4.1 什么是 Stash4.2 贮藏操作步骤4.3 恢复Unstash5. 实战场景一代码暂不想 Commit5.1 用 Stash Changes5.2 用 Shelve Changes6. 实战场景二Pull / Update 前防止冲突6.1 用 Shelve Changes6.2 用 Stash Changes7. 核心对比怎么选8. 命令行等价操作Stash10. 常见问题11. 小结适用工具IntelliJ IDEA / Android StudioJetBrains 系 IDE1. 为什么需要「暂存」本地改动日常开发中工作区里常有尚未写完、暂不想提交的代码。典型场景包括功能开发到一半突然被拉去修紧急 Bug需要切换分支本地改动与远程即将拉取的代码可能冲突需要先清空工作区再Update Project想尝试一种写法但不确定是否保留需要临时收起当前修改此时不必强行commit也无需丢弃代码。IDEA 提供了两种「先搁一边」的方式功能本质存储位置Shelve ChangesIDEA 内置能力项目.idea/shelf/与 Git 无关Stash ChangesGit 原生命令的可视化封装.git/refs/stash标准 Git 仓库两者都能把工作区改动暂时移走但机制、恢复方式和副作用不同。选对工具能少踩很多坑。2. 入口在哪里两种操作的菜单入口相同都在Git → Uncommitted Changes或左侧Git工具窗口中Shelve Changes…— 搁置到 ShelfStash Changes…— 贮藏到 Git Stash也可以左侧Git工具窗口对选中文件右键或直接点击上方的按钮。3. Shelve Changes 详解3.1 什么是 ShelveShelve搁置是 JetBrains IDE独有的功能字面意思是「把东西搁到架子上」。它把选中的变更保存到本地.idea/shelf/目录不经过 Git 提交历史也不影响git status。适合只在 IDEA 内开发不需要跨工具共享暂存内容需要按文件或代码块精细搁置比 Stash 更灵活希望搁置记录带 Changelist 名称方便回来继续3.2 搁置操作步骤在 Local Changes 中选中要搁置的文件可多选右键 →Shelve Changes…填写Commit Message作为搁置说明方便日后识别点击Shelve Changes搁置成功后这些文件会从当前工作区消失git status显示为干净状态。搁置的内容出现在「Shelf」Tab 中3.3 查看与恢复Unshelve搁置记录出现在Commit工具窗口的Shelf页签或 Version Control → Shelf。恢复方式在搁置记录上右键 →Unshelve…常用选项说明选项含义Set active恢复后自动激活对应 ChangelistTrack context跟踪上下文便于 IDE 记住关联任务Remove successfully applied files from the shelf恢复成功后从 Shelf 删除已合并的文件恢复后IDEA 通常会新建一个 Changelist名称即你搁置时填写的 Commit Message3.4 Shelve 的特点易踩坑搁置记录不会自动消失即使勾选了 RemoveChangelist 条目有时仍会留在 Commit 面板需手动删除空 Changelist搁置内容存在.idea/shelf/不会随git push同步到远程团队成员用其他编辑器打开项目时看不到你的 Shelf 内容4. Stash Changes 详解4.1 什么是 StashStash是 Git 的内置能力IDEA 的 Stash Changes 本质上执行的是gitstash push-m你的说明适合需要在命令行、SourceTree、GitKraken等其他 Git 工具中访问暂存团队协作、CI 流程依赖标准 Git 行为切换分支前快速「一键清空」工作区4.2 贮藏操作步骤在 Local Changes 中选中文件不选则默认贮藏全部 tracked 变更右键 →Stash Changes…填写说明点击确认对话框中常见选项选项建议Keep index一般不勾选。勾选后 staged 与 unstaged 分开贮藏容易产生多余 stash 记录日志也更乱Include untracked files若有新建未跟踪文件也要暂存需勾选贮藏后工作区变干净点击右侧的「Stash」Tab 可以看到暂存的内容4.3 恢复Unstash在Git → Stashes列表中对目标 stash 右键操作等价命令说明Apply Stashgit stash apply恢复改动保留stash 记录Pop Stashgit stash pop恢复改动删除该条 stashUnstash Changes…带选项的 apply/pop可勾选是否删除 stash恢复成功时IDEA 右下角通常有提示文件回到Default Changelist不会额外创建命名 Changelist。5. 实战场景一代码暂不想 Commit假设你在feature-A分支新增了一个文件DemoService.java功能未写完此时需要切到hotfix分支修 Bug。5.1 用 Stash Changes1. 右键 DemoService.java → Stash Changes不勾选 Keep index 2. 工作区干净 → 切换 hotfix 分支 → 修 Bug → 切回 feature-A 3. Git → Stashes → Pop Stash或 Apply Stash 4. DemoService.java 回到工作区5.2 用 Shelve Changes1. 右键 → Shelve Changes填写说明如 WIP: DemoService 半成品 2. 切换分支、修 Bug、切回 3. Shelf 页签 → Unshelve Changes勾选 Set active Track context 4. 变更进入名为 WIP: DemoService 半成品 的 Changelist此场景小结若只在 IDEA 内切换任务Shelve 的 Changelist 分类更清晰若可能用终端git stash选 Stash。6. 实战场景二Pull / Update 前防止冲突本地已 commit 若干次发现有问题需要git reset或远程有更新需要Update Project。若工作区还有未提交改动直接更新容易冲突。推荐流程先暂存 → 更新/回退 → 再恢复 → 手动解决冲突 → Commit6.1 用 Shelve Changes1. 搁置所有本地未提交改动 2. Update Project或 Reset 3. Unshelve勾选 Remove successfully applied files from the shelf 4. 解决冲突后 Commit注意即使 Shelf 记录被 RemoveCommit 面板里可能仍残留空 Changelist需手动清理。6.2 用 Stash Changes1. Stash Changes 贮藏全部改动 2. Update Project 3. Pop Stash或 Apply Stash 4. 解决冲突 → Commit 到 Default Changelist此场景小结Stash 恢复后文件集中在 Default Changelist结构更简单Shelve 可能留下多余 Changelist 需维护。7. 核心对比维度Shelve ChangesStash Changes来源IDEA 内置Git 标准命令存储.idea/shelf/.git/refs/stash跨工具❌ 仅 JetBrains IDE✅ 任意 Git 客户端恢复后组织新建命名 Changelist归入 Default Changelist删除暂存Unshelve 时可选 RemovePop 删除 / Apply 保留残留问题可能残留空 Changelist一般无多余列表精细度支持按文件/块搁置默认整批贮藏CLI 可-p是否进 Git 历史否否stash 不入 commit 历史怎么选只在 IDEA 内并行多个任务、喜欢 Changelist 分类 → Shelve 需要命令行/其他 Git 工具协作、追求简单无残留 → Stash 不确定时 → Stash更通用8. 命令行等价操作Stash若习惯终端Stash 对应关系如下# 贮藏等同 Stash Changesgitstash push-m说明文字# 查看贮藏列表gitstash list# 恢复并保留 stashgitstash apply stash{0}# 恢复并删除 stashgitstash pop stash{0}# 删除指定 stashgitstash drop stash{0}Shelve没有Git 命令行等价物只能通过 IDEA 界面操作。10. 常见问题QStash 后git stash pop冲突stash 还在吗APop 发生冲突时stash通常仍保留在列表中解决冲突后手动git stash drop即可。Q误 Pop 了 stash 能找回吗A可用git fsck --unreachable | grep commit配合git show尝试找回但操作繁琐。建议重要改动先Apply而非直接Pop。QShelve 和 Changelist 有什么区别AChangelist 是 IDE 对当前工作区变更的分组文件仍在工作区Shelve 是把变更移出工作区存到 Shelf。Changelist 适合并行开发多任务Shelve 适合临时清空工作区。QAndroid Studio 能用吗A可以。Android Studio 与 IDEA 同属 JetBrainsShelve / Stash 行为一致。11. 小结Shelve ChangesIDEA 专属带 Changelist 管理适合 IDE 内多任务切换但可能留下空 Changelist 需手动清理。Stash Changes标准 Git 能力跨工具通用恢复后归入 Default Changelist结构更干净。两者都是「不提交也能先收起来」的利器。根据你是否需要跨工具协作、是否依赖 Changelist 分类选择合适的方式即可。整理完毕完结撒花~参考地址1.idea中好用的git shelve changes和stash changeshttps://blog.csdn.net/eclipse1024/article/details/116352777