VSCode内置Git支持可完成日常版本控制，但需手动初始化仓库、显式添加新文件、填写提交信息；分支操作通过左下角状态栏进行，合并冲突需手动解决并提交；常见问题多因未打开仓库根目录或Git路径配置错误。
VSCode 内置的 Git 支持足够完成日常开发中的版本控制和分支操作，不需要额外安装图形工具或频繁切到命令行——但前提是得知道它默认不自动初始化仓库、不自动跟踪新文件，且分支切换时容易忽略未提交变更。
如何初始化仓库并首次提交
VSCode 不会替你 git init，必须手动触发或通过命令行创建。初始化后，它才能显示源代码管理（SCM）侧边栏的变更列表。
- 右键项目根目录 → “Git: Initialize Repository”（如果没看到，先按
Ctrl+Shift+P输入该命令） - 新增文件默认不会自动
git add，需在 SCM 面板中勾选文件，或点击文件旁的+图标 - 提交前务必填写提交信息（输入框在 SCM 顶部），空信息无法提交；可按
Ctrl+Enter快速提交 - 若看到
fatal: not a git repository错误，说明当前打开的文件夹不是 Git 仓库根目录，需重新用“文件 → 打开文件夹”选择正确路径
如何创建、切换和合并分支
VSCode 的分支操作集中在左下角状态栏，点击当前分支名即可唤出分支管理菜单，所有操作都是非阻塞式——但合并时不会自动解决冲突，也不会提示你 stash 未提交变更。
- 点击左下角分支名 → 选择 “Create new branch…”，输入名称（如
feature/login），回车即创建并切换 - 切换分支前，VSCode 会检查是否有未提交变更：若有，它允许切换但会把变更带到目标分支（可能引发意外污染），建议先提交或
git stash - 合并分支需先切换到目标分支（如
main），再点击分支名 → “Merge Branch…” → 选择要合并的分支 - 若出现冲突，VSCode 会高亮冲突块并提供“Accept Current Change”/“Accept Incoming Change”等快速操作按钮，但不会自动
git add解决后的文件，需手动勾选并提交
为什么有时看不到分支列表或提交历史
常见原因不是功能缺失，而是 VSCode 没有识别到 Git 仓库上下文，或 Git 可执行文件路径配置错误。
- 确认 VSCode 已安装官方 Git 插件（默认启用），并在设置中搜索
git.path，确保值为 Git 安装路径下的git可执行文件（Windows 常为C:\Program Files\Git\bin\git.exe） - 如果打开的是子文件夹而非仓库根目录，SCM 面板会显示
No source control providers are registered，此时需关闭当前窗口，用“文件 → 打开文件夹”选择含.git的目录 - 提交历史面板（可通过
Ctrl+Shift+G→ 点击右上角三个点 → “Show History” 打开）默认只显示当前分支，切换分支后历史会刷新；若空白，可能是仓库刚初始化且无提交，需先完成至少一次提交
真正容易被忽略的是：VSCode 的 Git 集成不会阻止你在存在未推送提交时强制切换远程分支，也不会警告你本地分支已落后于 origin/main。这些静默状态需要主动查看左下角分支名右侧的同步箭头（↑↓）或运行 Git: Fetch 手动比对。
