vscode的source control面板是轻量级git命令代理，仅操作暂存区（index）而不影响工作目录；它依赖系统git、需正确配置upstream才能推送，不替代git cli或gui。
VSCode 的 Source Control 面板不是 Git GUI，它只管“暂存”和“提交”，不处理底层仓库状态诊断或复杂分支操作。 你点错按钮、切错分支、推不到远端，往往不是面板坏了，而是没理解它背后调用的 git 命令边界。
Source Control 面板只操作暂存区（index），不碰工作目录
它显示的 “Changes” 和 “Staged Changes” 完全对应 git 的 index 状态：
- 文件在
Changes区 → 已修改但未git add - 点文件旁的
+或 “Stage Changes” → 执行git add <file></file>，仅把变更快照写入 index，工作目录内容不变 - 点 “Unstage Changes” → 执行
git restore --staged <file></file>（Git 2.23+）或git reset HEAD <file></file>，只是从 index 移出，不会丢弃你编辑的内容 - 右键选 “Discard Changes” → 才执行
git restore <file></file>，真正丢弃工作目录修改
常见错误现象：git status 显示有修改，但 SCM 面板空白 → 检查文件是否被 .gitignore 忽略，或 VSCode 是否识别错了仓库根路径（看左下角源控状态栏路径是否正确）。
分支切换按钮实际执行的是 git switch / git checkout
面板顶部下拉菜单 + “Checkout to” 和 “Create Branch” 是两个不同命令的快捷入口：
- “Checkout to” → 调用
git switch <branch></branch>（推荐）或git checkout <branch></branch>，要求目标分支已存在 - “Create Branch” → 默认执行
git switch -c <name></name>（或git checkout -b <name></name>），基于当前 HEAD 新建并检出 - 切换失败时（比如有未暂存修改冲突），VSCode 不会强制覆盖，而是弹窗提示 —— 这是保护机制，不是 bug
注意：它不会自动帮你 resolve 冲突。冲突文件会在 SCM 中标为 “Conflicts”，右键才能选 Accept Current / Incoming，这些操作直接写入工作目录，不自动 git add，你得手动 Stage 才能继续提交。
Push / Pull 按钮依赖 upstream 设置，不是无脑同步
VSCode 的 Push 和 Pull 按钮背后没有魔法，它们严格遵循 Git 的 upstream 规则：
- 执行
git push前，先检查当前分支是否设置了 upstream（即git branch --show-current对应的upstream） - 没设 upstream 时，Push 会弹窗让你选 remote（默认只认
origin）和 target branch；Pull 则直接报错No configured upstream branch - 解决方法只有两个：
git push -u origin <branch></branch>补上 upstream，或在命令面板运行Git: Set Upstream - 即使设了 upstream，
git.push.followTags在 VSCode 1.85+ 中也不生效 —— 打了 tag 后点 Push 不会推 tag，必须终端补git push --tags
别指望 UI 下拉选多个 remote：VSCode 不提供这个界面，remote 名硬编码为 origin，想换 remote 得改配置或走终端。
它本质是 git 命令行的轻量代理，不是独立 Git 实现
VSCode 自己不实现 Git 协议或对象数据库，所有操作都通过 child_process.spawn('git', [...]) 调用你系统装的 git 可执行文件：
- 启动时扫描项目根目录下的
.git文件夹激活 SCM 视图 - 定期跑
git status获取变更列表，用git diff渲染差异高亮 - 多仓库管理完全依赖
.code-workspace文件结构 —— 没它，SCM 就只认第一个.git - 如果你在集成终端里手动执行
git reset --hard，SCM 面板左下角分支名会更新，但文件图标（M/U/?）可能卡住不动，得点刷新按钮↻或用Git: Refresh
最常被忽略的一点：VSCode 默认开启 git.autoRepositoryDetection，它会递归扫整个工作区找 .git，容易把 node_modules/.git 或子模块误识别为独立仓库，导致面板卡顿或状态错乱 —— 生产环境建议关掉它，显式用多根工作区管理。
