配置gitLens的自动暂存功能可实现保存文件时自动添加到Git暂存区:1. 安装并启用GitLens扩展;2. 在设置中开启gitlens.autostage选项;3. 确保项目为已初始化且文件被跟踪的Git仓库;4. 可选配置保存时格式化与自动保存。注意新文件仍需手动添加。

vscode 本身不直接提供“保存文件时自动添加到 Git 暂存区”的功能,但可以通过扩展和设置组合实现类似效果。关键是使用 GitLens 或其他 Git 增强插件,并结合 VSCode 的保存后事件来触发 Git 操作。
1. 安装并启用 Git 扩展(推荐 GitLens)
GitLens 是一个强大的 Git 集成工具,增强了 VSCode 的 Git 功能:
- 打开 VSCode 扩展市场(Ctrl+Shift+X)
- 搜索 GitLens 并安装
- 重启或重新加载 VSCode 以启用扩展
2. 启用保存时自动暂存功能
GitLens 提供了“Auto Stage”选项,可在文件保存后自动将其加入暂存区:
- 打开 VSCode 设置(Ctrl+,)
- 搜索关键词 gitlens.autostage
- 勾选 Git › Autostage: When Saving Changes
说明:启用后,每次你保存一个已跟踪的文件,它会自动进入暂存区(staged),无需手动点击“+”号或运行 git add。
3. 确保项目已初始化 Git 仓库
该功能仅在当前项目是 Git 仓库时生效:
- 项目根目录下应有 .git 文件夹
- 若没有,可在终端执行:git init 初始化
- 确保文件已被 Git 跟踪(例如已提交过一次)
4. 可选:配合保存格式化等操作
如果你还希望保存时格式化代码并自动暂存,可同时开启:
- Files: Auto Save — 启用自动保存(可选)
- Editor: format On Save — 保存时格式化
- GitLens 的自动暂存会在此流程后触发
基本上就这些。配置完成后,每次保存修改过的已跟踪文件,它就会自动出现在“已暂存更改”区域,简化提交流程。注意:新文件(untracked)不会被自动添加,仍需手动执行 git add 或拖入暂存区。


