VSCode依赖系统Git实现版本管理，需确保git命令全局可用且路径配置正确；通过命令面板可快速执行Git操作；分支控件点击即切换，远程分支默认进入分离头指针状态；合并冲突须用内置按钮解决并点击“完成合并”确认。
VSCode 本身不自带 Git，它靠集成系统已安装的 Git 命令行工具来实现版本管理。没装 Git 或路径没配对，所有 Git 功能按钮都是灰色的——这是你遇到的第一道坎。
确认 Git 是否可用且路径正确
VSCode 的源代码管理（SCM）视图依赖 git 命令全局可用。如果点击“初始化仓库”没反应、右下角不显示分支名、提交按钮禁用，先排查这个。
- 终端里运行
git --version，必须有输出（如git version 2.40.1） - VSCode 设置里搜
git.path，确保值是 Git 可执行文件的绝对路径，例如：/usr/bin/git（macOS/Linux）或C:\Program Files\Git\bin\git.exe（Windows） - Windows 用户特别注意：别选
cmdgit.exe，要选bingit.exe，否则 SSH 认证、子模块等会失败
用命令面板快速触发常用 Git 操作
鼠标点来点去效率低。按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS），输入关键词直接执行，比找图标快得多。
-
Git: Initialize Repository—— 初始化本地仓库（仅当当前文件夹没.git时可用） -
Git: Clone—— 克隆远程仓库，支持 HTTPS 和 SSH URL，输入后自动打开新窗口 -
Git: Pull/Git: Push—— 拉取或推送，会自动识别当前分支和远程关联 -
Git: Commit—— 弹出输入框，支持多行提交信息；加-S签名需提前配好 GPG
理解状态栏分支控件的真实行为
右下角显示的分支名（如 main）不是装饰，它是可交互入口。但它的操作逻辑容易被误解。
- 点击分支名 → 列出本地所有分支 + “创建新分支” + “从远程拉取分支”选项
- 选一个本地分支 → 立即
git checkout，不弹确认；切换成功后编辑器不会刷新文件，但后续提交会写入该分支 - 选远程分支（如
origin/feature/login）→ VSCode 默认执行git switch --detach，进入分离头指针状态，非常危险，除非你明确想检出某次提交 - 想跟踪远程分支？得先选“创建新分支”，在输入框里填名字，再勾选“基于远程分支”并选中对应项
处理合并冲突时别跳过“接受更改”按钮
当 git merge 或 git pull 报冲突，VSCode 会高亮标记冲突块，并在编辑器顶部显示操作条。这里的关键动作不是手动删代码，而是用内置按钮解决。
- 每个冲突块上方会出现三组按钮：
Accept Current Change、Accept Incoming Change、Accept Both Changes - 点错一次就可能丢掉一方修改；尤其是
Accept Both Changes会保留双方内容但**不加任何分隔符**，需人工检查是否语义重复 - 解决完所有冲突后，必须点右上角的
✓（“完成合并”），否则git status仍显示未合并，也无法提交 - 误操作后想重来？运行
git merge --abort，VSCode 会自动刷新状态
真正卡住人的往往不是功能找不到，而是分支切换时的 detach 状态、冲突解决后忘了点“完成合并”、或者 Git 路径指向了错误的 git.exe。这些点不写进肌肉记忆，再多的图形按钮也救不了手忙脚乱的下午三点。
