VSCode中可部分暂存代码：选中连续代码块→右键→Stage Selected Ranges；不支持多段或空行，新建文件需先全量add；终端中可用git add -p实现更细粒度控制。
VSCode 里怎么只 stage 一部分代码（不是整文件）
能，但得先确认你用的是 VSCode 内置的 Git 集成（默认开启），且文件已处于“已修改”状态。VSCode 不支持像命令行 git add -p 那样交互式分块暂存，但提供了可视化方式——**选中代码块 + 右键 → Stage Selected Ranges**。
- 必须是已打开的文件，且编辑器中有明确选中的代码行（哪怕只选中一行、一个变量、一段注释）
- 右键菜单项叫
Stage Selected Ranges，不是Stage Changes（后者是整个文件） - 如果右键没看到这个选项，说明：当前没选中任何内容 / 文件还没被 Git 跟踪 / 正在对比暂存区（比如在 “Source Control → Changes” 视图里点开了 diff）
- 选中时跨了多个不连续区域？不行。VSCode 只支持单段连续选中 —— 这是它和命令行最实际的差距
为什么有时 Stage Selected Ranges 是灰色不可用
常见原因不是功能坏了，而是当前上下文不满足 Git 的“可暂存范围”判定逻辑：
- 文件是新建未跟踪状态（
Untracked）：VSCode 不允许只暂存部分新增内容，必须先git add整个加入索引，之后的修改才能分段 stage - 你正在看的是“暂存区 diff”（即点击了已暂存文件右侧的 ↕ 图标）：此时右键只有
Revert Selected Ranges，没有 stage 选项 —— stage 操作只能对“工作区修改”做 - 选中区域包含空行或纯空白行：VSCode 会跳过这些，但如果整段选中后实际无有效变更，选项也会变灰
- 文件编码异常或存在不可见控制字符（如
\r\n和\n混用）：可能导致 diff 计算失败，间接禁用该功能
git add -p 在 VSCode 终端里用不了？其实可以
VSCode 内置终端完全支持命令行 Git，git add -p 照常工作，只是交互方式和 GUI 不同 —— 它依赖终端按键响应，而 VSCode 默认终端可能禁用了部分交互模式。
- 确保你在项目根目录下运行：
git add -p（不要漏掉文件名，否则会遍历所有修改文件） - 如果按
y/n没反应，试试先按?呼出帮助，再确认终端焦点在正确位置（别误点了侧边栏） - Windows 用户注意：PowerShell 对
git add -p支持不稳定，建议改用 VSCode 集成的Git Bash或WSL终端 - 分块太细？用
s（split）把大 hunk 拆成更小单位，比 VSCode 的“连续选中”灵活得多
Stage 部分代码后，VSCode 的 diff 显示容易误导人
这是最容易忽略的细节：一旦你 stage 了部分修改，VSCode 左侧“SOURCE CONTROL”面板会同时显示两组 diff —— 上面是“暂存区 vs HEAD”，下面是“工作区 vs 暂存区”。但默认只展开其中一个，而且颜色含义容易混淆。
- 绿色背景 = 已暂存的新增（出现在“STAGED CHANGES”下）
- 蓝色背景 = 未暂存的新增（出现在“CHANGES”下）—— 注意：它不是“未修改”，而是“这次没被你 stage 的那部分”
- 如果你 stage 后又继续改了同一文件，新改的部分会叠加在“CHANGES”里，但旧的已暂存内容不会自动从“STAGED CHANGES”消失 —— 它们就是你最终要 commit 的内容
- 想确认到底哪些行进了暂存区？右键文件 →
Open Changes in Editor，然后手动对比两个 diff 区域
事情说清了就结束
