VS Code的版本控制是Git的图形化界面，依赖本地Git安装；需确认git --version有输出、状态栏显示分支、Git: Enabled启用；操作围绕源代码管理视图展开，推送前须手动配置remote，冲突可直接编辑解决；子模块、rebase等需终端操作。
VS Code 的版本控制功能不是独立系统，它只是 Git 的图形化操作界面——所有操作最终都调用你本地安装的 git 命令。只要 git 在终端能正常运行，VS Code 就能识别仓库并提供 UI 支持。
确认 Git 已正确安装并被 VS Code 识别
VS Code 不自带 Git，必须提前装好并确保其可被全局调用：
- 在终端执行
git --version，有输出（如git version 2.40.1）说明已安装 - VS Code 启动后，打开任意文件夹，左下角状态栏应显示分支名（如
main）；若显示Enable Git或无反应，说明未识别到 Git - 检查设置：
Settings > Features > Git: Enabled必须为启用状态；Git: Path若为空，一般自动发现；若自定义了 Git 路径（如 Windows 下C:\Program Files\Git\bin\git.exe），需填入完整路径
初始化仓库与提交更改的常规流程
VS Code 的源代码管理视图（Ctrl+Shift+G / Cmd+Shift+G）是核心入口，所有操作围绕它展开：
- 打开一个空文件夹 → 点击左下角
Initialize Repository，等效于执行git init - 添加文件后，左侧“暂存区”（Staged Changes）会列出已
git add的文件；点击文件旁的+可暂存，⋯菜单支持“暂存全部”或“撤销暂存” - 输入提交信息后按 Ctrl+Enter（Cmd+Enter），等效于
git commit -m "xxx"；不填消息无法提交 - 修改文件后，右侧“更改”（Changes）区域会显示差异，支持行级暂存（点击某行左侧的
+）和撤销（右键 →Discard Changes）
推送、拉取与处理冲突的关键操作
远程同步依赖 Git 远程配置，VS Code 不自动帮你配 origin：
- 首次推送前，先在终端运行
git remote add origin https://github.com/user/repo.git；否则点击“推送”按钮会报错fatal: No configured push destination - 推送/拉取通过顶部操作按钮完成：“…” →
Push/Pull；也可右键分支名选择Publish Branch（首次推新分支） - 拉取时发生冲突，VS Code 会高亮冲突标记（
<<<<<< HEAD等），直接在编辑器内编辑解决，保存后点击Accept Current Change或Accept Incoming Change按钮即可标记为已解决 - 注意：VS Code 默认不显示“未跟踪的远程分支”，如需 checkout 其他远程分支，仍需在终端执行
git checkout -b feat-x origin/feat-x
常见失效场景与绕过方案
VS Code 的 Git 集成在某些场景下会“失灵”，此时别硬点 UI，该切终端就切：
- 子模块（submodule）内容不显示在源代码管理视图中——这是设计限制，需手动进子模块目录执行
git status - 执行
git rebase或git cherry-pick等交互式命令时，VS Code 不提供 UI 支持，必须用终端 - 遇到
Unable to fetch due to merge conflict类提示，说明工作区存在未提交更改，VS Code 拒绝覆盖；要么先提交/暂存，要么用git stash临时保存 - 多根工作区（multi-root workspace）中，只有第一个文件夹能触发 Git 视图；其他根目录的 Git 状态不会汇总显示
git status git add . git commit -m "fix: handle null input" git push origin main
Git 集成的本质是降低常用命令门槛，不是替代命令行。真正卡住的时候，看一眼终端输出比反复点按钮更可靠。
