vscode 1.85+ 原生支持“只提交选中行”，需通过命令面板执行“git: stage selected ranges”或自定义快捷键触发，不依赖gitlens；但要求文件已跟踪、保存、utf-8编码且选区不跨hunk。
VSCode 提交部分代码行需要 Git 插件支持
原生 VSCode 的 Source Control 面板不支持“只提交选中行”，必须依赖 GitLens 或 VSCode 内置的（较新版本）git.stageSelectedRanges 命令。2023 年底起，VSCode 1.85+ 已将该功能移入核心，但默认未绑定快捷键，也不在右键菜单直接显示。
- 确认 VSCode 版本 ≥ 1.85：执行
Help > About查看；旧版本只能靠 GitLens - 该功能底层调用的是 Git 的
git add -p（交互式补丁），但 VSCode 封装为非交互式“选中即暂存” - 不依赖第三方扩展也能用，但需手动触发命令或配置快捷键——否则根本找不到入口
启用 Stage Selected Ranges 的两种可靠方式
最稳的方法是通过命令面板调用，其次是绑定快捷键。右键菜单在默认设置下不显示此项，别浪费时间找“Stage Selection”按钮。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Git: Stage Selected Ranges，回车执行 - 想固定使用？打开
Preferences: Open Keyboard Shortcuts (JSON)，添加：{ "key": "ctrl+alt+s", "command": "git.stageSelectedRanges", "when": "editorTextFocus && gitlens:enabled && !editorReadonly && !inDiffEditor" }注意：when条件里去掉gitlens:enabled（如果没装 GitLens），否则命令不生效 - 该命令仅在已打开的文件中有效，且当前文件必须已是 Git 仓库中的已跟踪文件（untracked 新文件不支持部分暂存）
常见失败现象和对应原因
点了命令没反应、提示“no changes selected”或直接报错，基本逃不出这几个原因：
- 选区跨了 Git 认为的“hunk”边界（比如选了两段不连续的修改，中间隔了未改动行）→ VSCode 拒绝暂存，会弹出提示
No valid selection ranges found - 文件编码不是 UTF-8（尤其含中文路径或 BOM 头）→
git.stageSelectedRanges可能静默失败，检查 VSCode 右下角编码显示，强制设为UTF-8 - 正在编辑的文件尚未保存 → 命令只作用于磁盘最新内容，务必先
Ctrl+S - 用了 WSL 或远程 SSH 连接但 Git 未正确配置路径 → 在 VSCode 设置里搜
git.path，确认指向的是能访问工作区的 Git 可执行文件（如/usr/bin/git）
和 git add -p 的关键区别与限制
VSCode 的 stageSelectedRanges 不是 git add -p 的图形化替代，它更像“精准快照”：只把当前选中的行当作一个完整 patch 暂存，不拆解、不合并、不跳过上下文。
- 不能跳过选区内的某几行（比如选了 5 行，只想暂存其中 3 行）→ 必须重新精确选中那 3 行再执行
- 暂存后，未选中的修改仍保留在工作区，但
git status显示该文件为 “both modified and staged” 状态，容易误判 - 撤销操作只能用
git restore --staged <file></file>，VSCode 的“discard changes”按钮会清掉整个文件的暂存+工作区修改，慎点 - 暂存的选区若含语法错误（如删了半个 if 语句），VSCode 不校验，Git 也不拦——提交后可能破坏可运行性
真正难的不是怎么点，而是判断哪些行该进、哪些该留。选错了，比全量暂存还难回滚。
