VSCode Git 可视化操作的难点在于状态错位、按钮语义模糊及“看似完成”实则未提交/推送；核心断层包括左下角数字非待提交数、合并时HEAD陷阱、冲突解决后需手动提交、rebase需命令面板触发、force push需手动执行，且所有自动化均依赖Git状态干净。
VSCode 的 Git 可视化操作本身不难，难在状态错位、按钮语义模糊、以及“看起来完成了”但实际没提交或没推送。多数问题不是功能不会用，而是没意识到 VSCode 的 UI 行为和底层 Git 命令之间存在几处关键断层。
提交前必须确认的三个 Git 状态
VSCode 左下角 Git 图标显示的数字，只是“未暂存 + 已暂存”文件总数，不是待提交数，更不是未推送数。你点了提交按钮却推不上去，大概率卡在中间环节。
- 如果
git status显示 “modified: file.js”，说明它还在工作区，没进暂存区 —— VSCode 里得手动点文件旁的+或右键Stage Changes - 如果显示 “staged for commit”，才真正进入暂存区；此时 VSCode 提交框里输完 message 按
Ctrl+Enter才会生成 commit - 如果想跳过暂存直接提交所有修改，VSCode 不支持
git commit -a那种行为；必须先 stage，否则提交框里的 “Commit All” 实际只提交已暂存项 -
git add -A比git add .更可靠：前者会跟踪新增、修改、删除三类变更，后者忽略已删除文件，容易漏掉D状态
合并分支时 VSCode 的两个 HEAD 陷阱
VSCode 合并操作默认按 CLI 语义执行：git merge feature/login 是在当前分支上合入 feature/login。UI 上不写明 base/head，导致点错分支是高频事故。
- 必须先切换到目标分支（比如
main），再右键feature/login→Merge from；如果状态栏还显示feature/login，点任何合并菜单都无效 - 合并前务必运行
git fetch（点右上角同步按钮等价），否则远程分支列表可能滞后，origin/main显示的仍是旧 HEAD，合进去的可能是过期代码 - VSCode 右键菜单里
Checkout to和Merge from是两个独立动作，名称接近但作用相反，点串就白忙活 - 若目标分支有未提交更改，VSCode 会静默阻止切换 —— 这时要么
git stash，要么先提交，别硬切
冲突解决后保存 ≠ 合并完成
VSCode 在冲突文件中保存后，会自动执行 git add 标记为已解决，但这只是“标记”，不是“提交”。整个合并流程卡在这一步的人最多。
- 冲突块里点击
Accept Current Change或Accept Incoming Change，只是编辑器行为，不触发任何 Git 操作；必须保存文件，VSCode 才会自动git add -
Accept Both Changes是最危险的快捷键：它不做逻辑判断，只拼接代码。两边都加了import React？保存后就是重复声明 - 多个冲突文件全部处理完后，源代码管理面板仍显示 “Merge in progress”，必须手动点提交按钮（或按
Ctrl+Enter），输入类似Merge branch 'feature/auth' into main的 message，才算真正完成合并 - 如果中途想放弃，终端执行
git merge --abort；VSCode GUI 没提供对应按钮
rebase 和 force push 的隐性门槛
VSCode 没有暴露交互式 rebase 的入口，靠右键菜单点 Squash 或 Fixup 容易误判效果 —— 它们只是改 todo 文件，不等于执行了 rebase。
- 要真正触发
git rebase -i，必须用命令面板（Ctrl+Shift+P）运行Git: Rebase Interactive，选起始提交后保存关闭临时编辑器 - 如果卡住不动，大概率是
core.editor没配对；应设为code --wait，否则 Git 等不到编辑器退出信号 - rebase 后
git push必然失败，因为历史被重写；VSCode 不会自动弹出 force push 提示，必须手动选Git: Push (force)或终端敲git push --force-with-lease -
Fixup会丢弃原提交 message，只保留变更 —— 如果你靠 message 记录调试过程，这步就等于丢日志
真正容易被忽略的是：VSCode 的“自动”行为（比如保存即 git add、合并成功即自动提交）全建立在 Git 状态干净的前提下。一旦工作区有未提交修改、暂存区混着多分支改动、或者 .git/config 里配了自定义 hook，这些自动化就会静默失效或半途卡死。别依赖 UI 看起来“动了”，终端敲一行 git status 永远是最短路径。
