vscode中git终端、图形界面与工作树必须协同才能真正提效：git.path配置错误会导致终端命令失效；图形界面提交会隐式处理未保存文件，而终端严格按暂存区执行；git worktree需新开窗口隔离状态；vscode-git-graph右键操作可替代70%终端命令。
VSCode 里 Git 不是“能用就行”，关键看终端、图形界面、工作树三者能不能真正协同——否则你只是把命令行搬进了编辑器，没解决多任务并行、状态混乱、切换卡顿这些真实痛点。
git.path 配不对我就别想用终端执行任何 Git 命令
VSCode 集成终端里敲 git status 报 command not found？不是终端坏了，大概率是 git.path 没配对。VSCode 不自动继承系统 PATH，尤其在 Windows 上装了 Git for Windows 却选了“Use Git from Windows Command Prompt”选项时，git.exe 实际在 C:Program FilesGitcmdgit.exe，而不是 bin 目录下。
- 打开 VSCode 设置（
Ctrl + ,），搜git.path - 填入完整路径，比如 Windows 上是
"git.path": "C:\Program Files\Git\cmd\git.exe"（注意双反斜杠） - 改完重启终端，再跑
git --version，有输出才算生效 - Mac/Linux 用户如果用 Homebrew 安装，路径通常是
/opt/homebrew/bin/git或/usr/local/bin/git，别直接抄网上的默认值
终端和图形界面混用时，git add . 和点击暂存按钮效果一样，但 git commit -m 和图形提交有个隐藏差异
图形界面点勾提交时，VSCode 默认会跳过空格校验、自动过滤掉未保存文件——而你在终端敲 git commit -m "fix: typo" 是严格按当前暂存区内容提交的。如果你改了文件但没手动 git add，又没保存文件，图形界面可能悄悄帮你补上；终端则直接报错“nothing to commit”。
- 日常开发建议：用图形界面暂存 + 终端提交，因为
git commit -v会弹出编辑器显示 diff，比图形界面的单行输入更防误提 - CI/CD 流水线脚本或自动化场景，必须统一走终端命令，避免图形界面隐式行为干扰
- 别在同一个项目里交替用两种方式做
git pull：图形界面默认走git pull --no-rebase，终端默认是git pull（取决于 config），容易导致 merge commit 和 rebase 混乱
git worktree create 后，VSCode 必须开新窗口，不能只换文件夹
很多人用 git worktree add ../my-feature feature/my-feature 创建工作树后，直接在原 VSCode 窗口里用“文件 > 打开文件夹”切过去，结果发现源代码管理面板还是显示 main 分支、git status 输出也不对——这是因为 VSCode 的 Git 扩展是按工作区根目录绑定仓库的，它不会自动识别新路径下的 .git 文件指向的是同一仓库的不同工作树。
- 正确做法：创建完工作树后，关掉当前窗口，用
code ../my-feature命令新开一个独立窗口 - 每个窗口对应一个物理目录 + 一个独立工作树，分支、暂存区、未提交修改完全隔离
- 别在同一个窗口里反复“打开文件夹”切换工作树目录，否则 SCM 视图和终端 Git 状态会错位，甚至引发
fatal: not a git repository - 清理时用
git worktree remove ../my-feature，别直接删文件夹，否则残留的gitdir引用会让主仓库出问题
vscode-git-graph 扩展不是“看看历史而已”，它的右键菜单能替代 70% 的终端 Git 操作
装了 vscode-git-graph 却只当它是个可视化工具？浪费了最大价值。它的上下文菜单（右键提交/分支/标签）直接调用 Git 命令，且自动处理路径、引用格式、安全确认——比如在图形里右键某个提交选“Cherry-pick”，它生成的是带完整 SHA 的 git cherry-pick abc1234，不会像手输那样漏掉前缀或拼错。
- 常用动作：右键远程分支 → “Pull from Remote Branch”；右键本地分支 → “Rebase onto…”；右键合并提交 → “View Merge Base”
- 配置
git-graph.contextMenuActionsVisibility可以关掉不常用的项（比如“Stash Changes”），避免菜单太长误点 - 它不依赖终端是否可用，即使
git.path配错了，只要 Git 在系统 PATH 里，图形操作依然能跑通
最常被忽略的其实是工作树和 vscode-git-graph 的组合：开两个窗口分别对应 feature 和 hotfix 工作树，再在每个窗口里用 Git Graph 查各自分支的拓扑关系——这时候你才真正脱离了“切分支→等构建→再切回来”的循环。终端命令只是工具，真正提效的是让不同 Git 操作落在不同抽象层上，各干各的活。
