VS Code 如何只暂存部分代码：Diff Editor 逐行 Stage 操作

同一个文件里同时改了格式和业务逻辑，直接点文件右侧的加号，往往会把两类修改一起放进提交。VS Code 的 Source Control 支持把范围缩小到代码块甚至选中行：打开 Diff Editor，选中目标改动，再点 gutter 里的 Stage，下一次提交就只会包含这一段。

步骤一：先把未提交文件集中到 Source Control

按 ⌃⇧G（Windows/Linux 使用 Ctrl+Shift+G）打开 Source Control。先看清两个区域：Changes 列出还没有暂存的新增、修改或删除文件，Staged Changes 列出已经准备好提交的内容。文件旁边的 M、U、D 只表示变化类型，不代表它已经进入暂存区。

步骤二：从 Changes 打开 Diff Editor 并定位目标改动

在 Changes 中点击目标文件，VS Code 会打开 Diff Editor。默认是左右对照：左侧是上次提交的版本，右侧是当前修改。先沿着颜色标记找到真正要提交的功能改动，再拖选对应行；格式化、临时日志或调试代码可以暂时不选。

大文件可以点击 Diff Editor 工具栏的 Collapse Unchanged Regions 收起未变化区域，也可以用 Next Change 和 Previous Change 在改动之间移动。这里的关键不是“选中几行看起来舒服”，而是确认选择范围能独立解释成一个提交。

步骤三：用 Stage Selected Ranges 暂存选中行

保持选区不变，在 Diff Editor 右侧变更 gutter 中点击 Stage。VS Code 只会把当前选中的代码块或行放入暂存区，不会把同一文件的其他未选改动一起带走。也可以右键选区，选择 Stage Selected Ranges；或者打开命令面板，运行 Git: Stage Selected Ranges。

如果 Stage 按钮没有出现，先检查是否真的在 Git 仓库中、文件是否位于 Changes，以及选区是否跨过了不连续的差异块。对完全不同的两个改动，分两次暂存更容易核对。

步骤四：回到 Staged Changes 核对提交边界

暂存完成后回到 Source Control 列表：目标内容应出现在 Staged Changes，没有选中的修改仍留在 Changes。点击已暂存文件可以再次打开暂存差异，确认没有混入无关行。发现范围过大时，悬停文件点击减号，或右键选择 Unstage Changes；这只会撤销暂存，不会丢掉本地修改。

确认边界后，再填写提交说明并点击 Commit。未暂存的修改会继续留在 Changes，不会因为这次提交自动消失。

常见问题

只点击文件旁边的加号可以暂存部分代码吗？

不行。文件旁边的加号面向整个文件；要缩小到代码块或选中行，需要进入 Diff Editor 使用 gutter 的 Stage 或 Stage Selected Ranges。

暂存后发现选多了，会丢失未提交内容吗？

不会。使用 Unstage 把内容放回 Changes，原本的工作区修改仍在，只是暂存边界被撤销。

为什么提交后还有文件留在 Changes？

这通常正是部分暂存的结果：只有 Staged Changes 会进入本次提交，未暂存修改会保留给下一次提交。

相关入口：VS Code 官方 Staging and committing changes 文档。