VS Code 怎么只暂存文件中的部分修改

同一个文件里同时改了两个功能，却只想先提交其中一部分时，不必把整份文件都加入暂存区。VS Code 的差异编辑器支持按行或代码块暂存：从 Changes 打开文件差异，选中目标行，再用沟槽里的 Stage 按钮，或执行 Stage Selected Ranges。成功后，同一文件可以同时出现在 Staged Changes 和 Changes 中。

官方文档：https://code.visualstudio.com/docs/sourcecontrol/staging-commits

开始前先确认三个条件

电脑需要已经安装 Git，当前文件位于 Git 仓库中，并且修改已经保存到磁盘。本文使用 VS Code 自带的 Git 集成功能；不同显示语言下，菜单可能显示为“暂存所选范围”或英文 Stage Selected Ranges，作用相同。

VS Code 只暂存部分修改的操作步骤

1. 第一步：从 Changes 打开文件差异

   在 Windows 或 Linux 中按 Ctrl+Shift+G 打开 Source Control；也可以直接点击左侧活动栏的源代码管理图标。在 Changes 列表中单击目标文件，例如 app.js。这一步只打开“暂存区版本与工作文件”的差异，不会执行暂存。

   可见状态：中央出现差异编辑器，新增行通常用绿色标出，修改行会显示对应的差异块。

   

2. 第二步：选中真正要放进下一次提交的行

   在差异编辑器的修改侧，用鼠标拖选需要提交的连续代码行。选区可以只覆盖一个差异块中的几行，也可以覆盖整个代码块。选择前先检查语义边界：函数签名、调用点和配套测试如果属于同一项修改，应该一起选中，避免把不能独立工作的半段代码放进暂存区。

   可见状态：目标行保持选中，旁边的差异沟槽出现可操作的 Stage 按钮。

3. 第三步：只暂存当前选区

   点击选区旁差异沟槽中的 Stage 按钮，即可只暂存这些行。也可以在选区上右键，选择 Stage Selected Ranges；另一条等价路径是打开命令面板，运行 Git: Stage Selected Ranges。不要点击 Changes 标题或文件旁的加号，那些入口会暂存整个范围或整份文件。

   可见状态：被暂存的行从当前“未暂存差异”视图中移出，未选中的修改仍留在原处。

   

4. 第四步：分别核对已暂存和未暂存内容

   回到 Source Control。点击 Staged Changes 里的文件，看到的是当前提交将包含的内容；点击 Changes 里的同名文件，看到的是仍未暂存的内容。官方文档明确说明，文件可以同时出现在两个列表中，这正是局部暂存后的正常状态。

   可见状态：同一个 app.js 同时出现在 Staged Changes 与 Changes。前者回答“下次提交包含什么”，后者回答“还有哪些修改没暂存”。

   

5. 第五步：误暂存时先撤回，再重新选择

   如果选错了范围，可在 Staged Changes 中打开该文件，选中需要移出暂存区的行，使用差异沟槽的 Unstage 按钮。若整份文件都暂存错了，可在文件旁点击减号，或右键选择 Unstage Changes。撤销暂存只会把内容移回 Changes，不会删除工作文件中的修改。

常见问题

为什么右键菜单里没有 Stage Selected Ranges？

先确认你打开的是 Changes 中的文件差异，而不是普通编辑器；然后在修改侧真实选中一段变更行。若仍找不到，可按 Ctrl+Shift+P 打开命令面板，输入 Git: Stage Selected Ranges。Git 未安装、文件不在仓库内或文件修改尚未保存，也会导致相关操作不可用。

为什么暂存后文件还在 Changes 里？

这是正常现象。局部暂存只把选中的内容复制到 Git 暂存区，未选中的修改仍保留在工作文件里。因此同一文件会分成“已暂存快照”和“未暂存修改”两部分，分别出现在两个列表中。

点击 Commit 会不会把未暂存部分也提交？

正常的 Commit 使用已暂存内容；未暂存修改会继续留在 Changes。为了避免受个人 Git 设置或交互提示影响，提交前应明确核对 Staged Changes，不要选择 Commit All。

局部暂存后又继续编辑，会发生什么？

暂存区保存的是执行暂存那一刻的内容。之后新增的编辑不会自动进入该快照，保存后会继续显示在 Changes。需要把后续修改也纳入同一次提交时，必须再次暂存。

最终确认

提交前依次打开 Staged Changes 和 Changes 中的同名文件：前者只包含本次计划提交的完整逻辑，后者保留其他工作；确认无误后再填写提交信息并点击 Commit。暂存、提交和推送是三个独立动作，完成局部暂存并不等于已经提交或上传。