VSCode 提供五种 Git 暂存方式：一、源代码管理视图交互式暂存；二、命令面板执行“Git: Stage Changes”或“Git: Stage Selected Ranges”；三、右键菜单快速暂存/撤回；四、SCM 视图中多选文件后按 Enter 批量暂存；五、启用 git.promptToStageUnstagedChanges 设置实现保存时自动提示暂存。

如果您在使用 VSCode 进行 Git 版本控制时希望对文件变更进行细粒度管理，Staging 功能可让您选择性地将特定修改加入暂存区，而非一次性提交全部改动。以下是实现该功能的多种操作路径：

本文运行环境：MacBook Air，macOS Sequoia。

一、通过源代码管理视图交互式暂存

VSCode 的源代码管理侧边栏提供可视化界面，支持逐行、逐块或整文件暂存，适用于需精确审查变更内容的场景。

1、点击左侧活动栏中的源代码管理图标（分支图标）打开 SCM 视图。

2、在“CHANGES”区域下找到目标文件，点击文件名右侧的+（加号）按钮将其整体暂存。

3、若需部分暂存，点击文件名旁的…（更多操作）按钮，选择“Stage Selected Ranges”。

4、在弹出的差异编辑器中，勾选要暂存的代码块左侧复选框，未勾选部分保留在工作区。

二、使用命令面板执行暂存命令

命令面板提供快捷入口，绕过图形界面直接调用 Git 暂存逻辑，适合熟悉快捷键与命令语义的用户。

1、按下 Cmd+Shift+P（macOS）或 Ctrl+Shift+P（Windows/Linux）打开命令面板。

2、输入并选择“Git: Stage Changes”命令，确认后暂存所有已修改且未暂存的文件。

3、如需暂存部分变更，输入并选择“Git: Stage Selected Ranges”，随后在差异视图中手动选取。

三、通过右键上下文菜单快速暂存

在文件资源管理器或 SCM 更改列表中启用右键菜单，可减少导航层级，提升高频暂存操作效率。

1、在资源管理器中右键单击一个未暂存的文件。

2、从上下文菜单中选择Stage Changes，该文件所有变更立即进入暂存区。

3、若文件处于已暂存状态，右键菜单中会显示Unstage Changes选项，用于撤回暂存。

四、利用键盘快捷键批量暂存

为加速多文件处理，VSCode 支持在 SCM 视图中通过键盘组合完成批量暂存，无需鼠标介入。

1、聚焦 SCM 视图中的“CHANGES”文件列表。

2、按住 Cmd（macOS）或 Ctrl（Windows/Linux）并点击多个文件以多选。

3、按下 Enter 键，所选文件全部执行暂存操作。

五、通过设置启用自动暂存提示

当开启相关设置后，VSCode 会在保存含未暂存变更的文件时弹出提示，辅助用户养成阶段性暂存习惯。

1、打开设置界面，搜索关键词 git.autoRepositoryDetection，确保其值为 true。

2、继续搜索 git.promptToStageUnstagedChanges，将其设为 true。

3、完成设置后，保存含未暂存变更的文件时，底部状态栏将出现“Stage changes before commit?”提示条。