当前位置：首页 > 文章列表 > 文章 > 软件教程 > VS Code 怎么只暂存文件中的部分修改

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

来源：17golang原创 2026-10-04 02:51:32 0浏览收藏

同一个文件里同时改了两个功能，却只想先提交其中一部分时，不必把整份文件都加入暂存区。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 只暂存部分修改的操作步骤

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

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

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

图1：从 Source Control 的 Changes 列表选择文件，打开该文件的未暂存差异。配图为 ImageGen 原创界面说明图。
第二步：选中真正要放进下一次提交的行

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

可见状态：目标行保持选中，旁边的差异沟槽出现可操作的 Stage 按钮。
第三步：只暂存当前选区

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

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

图2：选中目标行后使用沟槽 Stage 按钮，或执行 Stage Selected Ranges，只暂存当前选区。配图为 ImageGen 原创界面说明图。
第四步：分别核对已暂存和未暂存内容

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

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

图3：同一文件同时出现在 Staged Changes 与 Changes，说明一部分已进入暂存区，其余修改仍未暂存。配图为 ImageGen 原创界面说明图。
第五步：误暂存时先撤回，再重新选择

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

常见问题

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

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