VS Code Diff Editor 怎样只暂存部分代码

在 VS Code 里，如果直接点击 Source Control 中某个文件旁边的“+”，通常会把这个文件当前的全部改动放进暂存区。想把格式化、修复和临时调试代码拆成不同提交时，应打开 Diff Editor，只选择需要提交的代码行，再执行 Stage Selected Ranges。

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

这篇只讨论本地 Git 仓库中的部分暂存：它不会删除未选中的工作区改动，也不会自动创建 commit 或推送远端。

先从 Changes 打开 Diff Editor

用 macOS 的 ⇧⌘G，或 Windows/Linux 的 Ctrl+Shift+G 打开 Source Control。展开 Changes，点击目标文件，VS Code 会打开差异编辑器。左侧是仓库中的旧内容，右侧是当前工作区内容；要暂存的行应在右侧改动区域中选择。

如果文件没有出现在 Changes，先确认当前打开的是包含 Git 元数据的仓库目录；VS Code 的内置 Git 功能依赖本机 Git 和已识别的仓库。

只暂存选中的代码行

1. 在 Diff Editor 右侧拖选要放入本次提交的连续代码行。
2. 把鼠标移到选区附近的差异槽位，点击出现的 Stage 按钮。
3. 也可以右键选区，选择 Stage Selected Ranges；或者打开命令面板，运行 Git: Stage Selected Ranges。

这一步的关键是“选区必须覆盖变更行”。如果只选中了没有变化的上下文行，VS Code 没有可加入暂存区的差异，按钮可能不会按预期出现。对于相邻的两段改动，可以分别暂存，随后再到 Staged Changes 中确认本次提交的范围。

用两组列表确认暂存结果

回到 Source Control 后，文件可能同时出现在 Staged Changes 和 Changes 中。这不是重复文件，而是同一文件被拆成了两部分：已选中的片段在 Staged Changes，未选中的片段仍在 Changes。分别点击两组中的文件，可以再次打开差异视图，确认本次提交不会带上无关修改。

暂存只决定下一次 commit 的内容，工作区中没有暂存的代码仍然保留。提交前可以用下面的命令查看暂存区差异；命令中的中文注释说明检查目的。

# 查看已经进入下一次提交的差异
git diff --cached

# 查看仍留在工作区、尚未暂存的差异
git diff

选错时如何撤回而不丢代码

如果整段暂存错了，在 Staged Changes 中右键文件，选择 Unstage Changes，文件会回到 Changes，工作区修改仍在。若只想撤回其中一部分，可重新打开 Diff Editor，选择已暂存的片段，再使用行间的 Unstage，或者使用对应的取消暂存命令。

常见误区有三个：把文件旁的“+”当成部分暂存、把 Staged Changes 误认为已经提交、以及切换分支前忘记处理 Changes 中剩余的改动。只要提交前分别展开两组列表并查看差异，就能把“本次提交内容”和“稍后再处理内容”分开。

相关问题

为什么同一个文件会同时出现在两个列表？因为文件中的不同差异块处于不同状态，部分已暂存、部分仍在工作区。

暂存部分代码会删除未选中的代码吗？不会。暂存只更新 Git index，未选中的改动仍保留在工作区。

Stage Selected Ranges 找不到怎么办？先在 Diff Editor 右侧选中实际改动行，再从右键菜单或命令面板执行该命令。