IntelliJ IDEA Git Stash 暂存功能实战指南
一、什么是'暂存'？
在 Git 版本控制里，Stash（暂存）是个非常实用的功能。在 IntelliJ IDEA 的界面中，它被翻译为'隐藏更改'。简单来说，就是把当前工作目录里那些还没提交的修改先收起来，临时保存好。这样你就不用担心切换分支时代码冲突，或者拉取远程更新时产生麻烦，随时能把手头的进度捡回来。
二、什么时候该用 Stash？
实际开发中，遇到下面几种情况，我通常会优先选择暂存：
- 切换分支前：手头代码改了一半，但突然需要切到另一个分支修个紧急 Bug。
- 拉取远程更新前：本地有改动，直接 pull 容易冲突，先 stash 一下再拉取更稳妥。
- 临时保存进度：想换个思路写点别的，先把当前的状态存个档。
- 清理工作区：想把未提交的脏数据清掉，让项目目录看起来清爽点。
三、IDEA 中的操作细节
1. 唤起暂存窗口
在 IDEA 里唤起这个功能挺方便的，我有几个习惯用法：
- 右键菜单：在项目根目录或具体文件上右键，选
Git→Hide Changes...（隐藏更改）。 - 顶部菜单：点击
VCS→Git→Hide Changes...。 - 快捷键：虽然 IDEA 默认没有直接的 Stash 快捷键，但可以通过
Ctrl + Alt + A快速添加文件到暂存区，不过针对 Stash 操作，建议还是通过菜单确认，避免误操作。
2. 配置暂存参数
点击后弹出的对话框里，有几个关键点要注意：
- Git 根路径：显示当前仓库位置，一般不用动。
- 当前分支：确认你是在哪个分支上操作的。
- 消息 (Message)：强烈建议填写。比如'用户登录功能 - 未完成验证逻辑'，以后查记录时一眼就能看懂当时干了啥。
- 保留索引 (Keep Index)：这是个开关。如果勾选，已添加到暂存区（Stage）的文件会保留下来；不勾选的话，所有修改（包括已暂存的）都会被打包带走。
3. 执行暂存
填好描述，确认选项无误，点蓝色的 Create Stash 按钮就行。这时候你的工作区应该变干净了，就像什么都没发生过一样。
四、如何管理暂存记录
查看列表
打开 Git 工具窗口（快捷键 Alt+9），切换到 Log 标签页，展开左侧导航找到 Repository → Stash，就能看到之前存过的所有快照。
恢复与丢弃
- 应用 (Apply)：右键某条记录，选
Apply Stash。这会恢复代码但不删除记录，适合反复测试。 - 弹出 (Pop)：选
Pop Stash。恢复代码的同时把这条记录删掉，相当于一次性完成转移。 - 删除：如果确定不需要了，右键选
Delete Stash清理掉。
五、避坑指南与技巧
✅ 最佳实践
- ：别留空消息，清晰的描述能省掉很多排查时间。
