JetBrains IDE 怎么用 Shelf 暂存未完成修改

JetBrains IDE 的 Shelf 适合“代码还没写完，但现在必须切到另一项任务”的场景。它会把选中的受版本控制修改保存成 IDE 管理的 shelf，并把这些修改从当前工作区移开；需要继续时，再从 Shelf 标签页执行 Unshelve 恢复。

官方帮助地址：https://www.jetbrains.com/help/idea/shelving-and-unshelving-changes.html

第一步：在 Commit 工具窗口选中要暂存的修改

1. 打开已经启用版本控制的项目，确认文件确实处于 Modified 状态。
2. 打开 Commit 工具窗口。官方默认快捷键是 Alt+0；若当前键位方案不同，也可以从工具窗口栏进入。
3. 在修改列表中选中一个文件、多个文件或整个 changelist。
4. 右键选区，点击 Shelve Changes。

继续前的可见状态：屏幕应出现 Shelve Changes 对话框，并列出刚才选中的修改。若菜单不可用，先确认文件已经加入版本控制；官方说明明确指出，未版本化文件不能被 Shelve。

第二步：核对文件、差异和 Shelf 名称

1. 在对话框的文件列表中检查要保存的修改。默认会选中列表里的全部文件，可取消不需要暂存的项。
2. 点击某个文件，在 Diff 区域核对本地版本与仓库版本的差异，避免把无关改动一起移走。
3. 在 Commit Message 字段输入便于识别的名称，例如“支付页校验未完成”。名称最好包含任务和当前阶段，不要长期保留大量名为 Default 的 shelf。
4. 点击 Shelve Changes 完成保存。

继续前的可见状态：对话框关闭后，刚才选中的修改应出现在 Shelf 标签页；当前 Commit 列表中对应修改会减少或消失。此时 Shelf 保存的是补丁式修改，不等于已经创建 Git 提交。

第三步：确认 Shelf 已保存，再切换任务

切换分支或处理紧急问题前，先打开 Shelf 标签页，确认列表里能看到刚创建的名称和文件数量。双击其中的文件可查看差异。只有当 shelf 条目和文件清单都可见时，才把它视为已完成暂存。

如果希望保留当前工作区修改，同时额外复制一份到 Shelf，不要使用普通 Shelve。按 Ctrl+Shift+A 打开动作搜索，查找 Save to Shelf。这个动作会保存副本，而不会重置本地修改。

第四步：从 Shelf 标签页恢复修改

1. 完成临时任务后，回到 Commit 工具窗口并打开 Shelf 标签页。
2. 选中要恢复的 shelf 或其中的部分文件，右键点击 Unshelve。官方默认快捷键为 Ctrl+Shift+U。
3. 在 Unshelve Changes 对话框中，为恢复后的 changelist 输入名称，或者选择已有 changelist。
4. 需要立即使用该 changelist 时勾选 Set active。希望成功恢复后从当前 shelf 移走文件时，再勾选 Remove successfully applied files from the shelf。
5. 点击 OK。

验收状态：恢复的文件重新出现在 Commit 列表中，编辑器内能看到原来的改动，目标 changelist 名称与选择一致。若没有选择删除成功应用的文件，Shelf 中仍可保留该条目，之后还能再次应用。

Shelf 和 Git Stash 怎么选

如果团队工作都围绕 JetBrains IDE，且你经常只想移开部分文件，Shelf 更直观；如果记录需要被命令行、其他 IDE 或自动化脚本识别，Stash 更合适。

恢复时出现冲突怎么办

Unshelve 会把保存的补丁应用到当前代码。如果当前分支在同一区域已经发生变化，IDE 会进入冲突处理流程。不要反复点击 Unshelve；先在冲突界面比较当前版本、shelf 版本和合并结果，完成冲突解决后再检查 Commit 列表。

误删已经 Unshelve 的文件时，可在 Shelf 视图中启用 Already Unshelved，找到相应条目后执行 Restore。普通 Unshelve 后的内容可以重复应用，直到你明确删除它。

常见问题

为什么右键菜单里没有 Shelve Changes？

先确认项目已经启用版本控制、文件在 Commit 工具窗口的修改列表里，并且文件不是未跟踪状态。未加入版本控制的文件不能直接 Shelve。

Shelve 后代码会提交到远程仓库吗？

不会。Shelf 只是 IDE 管理的临时修改，不会创建提交，也不会自动推送到远程仓库。

能不能只恢复 Shelf 里的一个文件？

可以。在 Shelf 标签页展开条目，只选中需要的文件再执行 Unshelve，其余文件仍可保留在 shelf 中。

如何快速 Shelve，不打开确认对话框？

可使用 Shelve Silently，官方默认快捷键为 Ctrl+Shift+H。它会使用 changelist 名称作为 shelf 名称，适合内容已经核对清楚的情况。