VS Code 源代码管理怎样暂存未提交改动

VS Code 中想把尚未提交的改动先收起来，应使用 Git Stash：打开源代码管理的“…”菜单，在 Stash 子菜单选择保存操作，或通过命令面板搜索 Git: Stash。文件旁的“+”是 Stage Changes，只把内容放入暂存区，不能代替 Stash。需要连新建文件一起收起时，选择 Stash (Include Untracked)。

官方地址：https://code.visualstudio.com/

下面以“正在修改筛选面板，临时要处理另一个任务”为例，使用一个已有提交历史的 Git 仓库。先保存编辑器内容，再收起工作区改动；回来后用 Apply Stash 恢复并检查。不同语言包会翻译菜单，因此同时保留英文操作名称。图片均为原创界面说明图，不是实际软件截图。

步骤1：保存文件并选择 Stash 保存范围

在 File → Save All（文件 → 全部保存）保存文件，再点击左侧活动栏的 Source Control（源代码管理）。工作区有多个仓库时，先确认操作的是目标仓库。查看 Changes 和 Staged Changes 中的文件，点开差异确认哪些修改需要收起；编辑器中尚未保存到磁盘的文字不应指望由 Git 自动保管。

点击目标仓库的 More Actions（…）→ Stash → Stash，输入能识别内容的说明，例如“筛选面板布局未完成”，然后确认。如果改动里有新建但尚未跟踪的文件，改选 Stash (Include Untracked)。也可从 View → Command Palette… 搜索 Git: Stash 或 Git: Stash (Include Untracked)，避免在多层菜单中寻找。

保存后，纳入 Stash 的改动应从当前更改列表中移走。普通 Stash 后仍看到标记为 U 的新文件，并不必然表示保存失败，它可能根本没有被纳入。可以通过命令面板的 Git: View Stash... 查看记录，确认出现自己填写的说明。被忽略文件与普通未跟踪文件是两种范围，Include Untracked 不能被理解成包括所有磁盘文件。

步骤2：用 Apply Stash 恢复指定记录

完成临时任务并回到希望恢复改动的分支后，先处理当前工作区的其他修改，避免把两份工作混在一起。打开 View → Command Palette… → Git: Apply Stash...，在记录列表中选中“筛选面板布局未完成”。同一操作也可从源代码管理的 … → Stash 子菜单进入。

选择带省略号的 Apply Stash，是为了明确挑选记录；不要只凭“最新”猜测要恢复哪份工作。Apply 会尝试把所选改动应用到当前工作区，并保留原记录。成功后，源代码管理列表应重新出现相关文件，打开差异应能看到需要继续编辑的内容。

恢复不等于提交，也不一定恢复成原来完全一样的暂存区分组。重点检查文件内容、差异范围和需要提交的集合。若只是想回看，不要反复执行 Apply；同一份记录多次应用可能与已经恢复的内容发生冲突。

步骤3：检查恢复差异并处理冲突

如果恢复时出现冲突，先停下重复 Apply 或 Pop 的操作。在 Source Control → Merge Changes（合并更改） 中打开冲突文件，比较当前文件与 Stash 带回的修改。可使用编辑器提供的 Accept Current Change、Accept Incoming Change 等选择，也可以手动编辑保留两侧需要的内容；不能把“接受全部”当成固定答案。

当冲突来自 Stash 应用时，当前一侧对应当前工作区或分支内容，传入一侧对应收起的改动。仍要逐块阅读，尤其是双方都改了同一条件或函数的情况。编辑完成后保存文件，再点击文件旁的 +（Stage Changes）标记已解决，并重新查看差异。这里的“+”用于冲突解决后的暂存，与第一步的 Stash 目的不同。

没有冲突时同样要打开恢复文件检查。建议关注新增文件是否回来、删除和重命名是否符合预期，以及当前分支的新逻辑有没有被覆盖。按项目自己的方法运行必要检查后再提交；仅看到更改数量恢复，不能证明业务内容已经合并正确。

确认恢复后再清理记录

使用 Apply 恢复的记录仍在列表中。确认内容已妥善保留后，可从命令面板选择 Git: Drop Stash...，按说明定位这一条再删除；清理前重新查看记录列表，避免用之前记住的序号判断。不要为了删除一条记录选择 Drop All Stashes。

如果 Pop 因冲突没有完成，Git 通常会保留原 Stash，解决冲突后需要自行决定何时删除。Stash 保存在本地仓库，普通推送分支不会把它当作分支提交一起发布；长期工作应整理成可追溯的提交或适当备份，不宜只靠一长串 Stash 名称保存进度。

常见问题

为什么 Stash 后新建文件还在？

检查是否选了 Include Untracked，以及该文件是否被忽略。普通 Stash 与包含未跟踪文件的保存范围不同。

为什么提示没有可以收起的改动？

先保存编辑器，再确认仓库选择和当前更改列表。只有未保存缓冲区修改、选错仓库或当前确实没有相关改动，都可能与预期不符；不要通过丢弃文件来“修复”这个提示。

恢复到另一分支一定不会冲突吗？

不能保证。Stash 是把保存的改动重新应用到当前上下文，两个分支改动范围重叠时可能冲突，按差异处理即可，不应自动选择覆盖当前文件。

这个操作完成的标志是：记录说明明确、保存范围符合预期、恢复后的内容经过逐项查看。把 Stage、Stash、Apply 与 Pop 分清，才能在临时切换任务后找回正确的工作进度。

参考：VS Code 分支与 Stash 操作、VS Code 冲突处理、Git stash 命令说明。