VSCode的Git功能依赖本地git命令、正确路径配置及.git仓库根目录三者缺一不可；若git --version在终端有效但VSCode不识别，需检查PATH继承问题并手动配置git.path；初始化仓库须先用终端执行git init或git clone再打开对应文件夹；分支切换前需暂存或丢弃未提交更改；解决冲突后须手动暂存并提交才能完成合并；首次推送前必须终端配置remote。
VSCode 的 Git 功能本身不独立运行，所有操作都依赖你本地安装的 git 命令行工具是否可用、路径是否配置正确、当前打开的文件夹是否为 Git 仓库根目录——这三个条件缺一不可，否则你会看到 SCM 视图空白、分支名不显示、提交按钮禁用等现象。
git --version 能运行但 VSCode 不识别 Git 怎么办
这是最常卡住用户的起点。VSCode 启动时不会自动继承终端的 PATH 环境变量，尤其 macOS GUI 启动和 Windows 安装未勾选“Add to PATH”时极易发生。
- 在 VSCode 内置终端（
Ctrl+`）中运行git --version，必须有输出；若报command not found，说明 VSCode 没加载到系统git - macOS 用户检查
~/.zshrc（或对应 shell 配置）是否含export PATH="/opt/homebrew/bin:$PATH"（Homebrew 安装）或export PATH="/usr/local/bin:$PATH"（Xcode Command Line Tools），改完后关闭并重开 VSCode - Windows 用户确认安装 Git for Windows 时勾选了 “Add Git to the system PATH”，否则手动在 VSCode 设置中搜
git.path，填入C:\Program Files\Git\bin\git.exe（注意不是cmd\git.exe） - 验证方式：按
Ctrl+Shift+P输入Git: Show Git Output，输出面板应显示类似Using git 2.40.1 from /usr/local/bin/git
点击“Initialize Repository”没反应或 SCM 视图为空
VSCode 不会自动向上搜索 .git 目录，也不接受子目录作为工作区——它只认你用“文件 → 打开文件夹”选中的那个文件夹下是否存在 .git 子目录。
- 先在终端进入目标文件夹，执行
git init或git clone，再用 VSCode 打开该文件夹（不是父级或子级） - 打开后看左下角状态栏：应显示分支名（如
main），若显示Enable Git或无任何内容，说明没识别到仓库 - 右键 SCM 视图空白处 → “Refresh” 或按
Ctrl+Shift+P运行Git: Refresh强制重载状态 - 确认
.git文件夹真实存在且未被隐藏：在终端执行ls -la（macOS/Linux）或dir /ah（Windows）查看
切换分支时报 “Your local changes would be overwritten”
VSCode 默认禁止覆盖未提交的修改，但它的提示不明确，容易让人误以为是 bug。这不是限制，而是保护机制——你需要主动决定保留、丢弃或暂存这些变更。
- 想保留修改并带到新分支：先在 SCM 视图中点击文件旁的
+暂存，再提交（或右键文件 →Stash Changes） - 想丢弃全部未提交修改：点击 SCM 顶部的
Discard All Changes按钮（⚠️不可逆） - 想丢弃单个文件修改：右键该文件 →
Discard Changes - VSCode 不提供图形化强制切换（如
git checkout -f），这类操作必须回终端执行，避免误覆盖
合并冲突后点“Accept Incoming Change”却无法推送
VSCode 解决冲突只是编辑器内的标记动作，它不会自动 git add 已解决的文件，也不会自动完成 git commit。这两步必须手动补全，否则合并仍处于“进行中”状态。
- 每个冲突文件编辑保存后（
Ctrl+S），必须回到 SCM 视图，找到该文件，在STAGED CHANGES区域点击其旁的+将其加入暂存区 - 所有冲突文件都暂存后，顶部提交框输入信息，按
Ctrl+Enter提交——这才是真正的合并完成 - 如果中途关闭了冲突编辑器，可在命令面板输入
Merge Conflict: Accept Current Change快速调出操作面板 - 别依赖顶部“Sync Changes”按钮：它执行的是
git pull --rebase && git push，一旦中间某步失败（比如 rebase 冲突），就会停住，不会跳过
最容易被忽略的是：VSCode 从不自动帮你配远程仓库。首次推送前，必须在终端执行 git remote add origin <url>，否则点击“Publish Branch”或“Push”都会报 fatal: No configured push destination——这个步骤没有图形化替代方案。
