vs code的scm视图是轻量git操作入口，需git已安装并正确配置；它自动监听根目录.git、支持stage/commit/push/pull等操作，但依赖命令行逻辑，关键操作前应运行git status确认状态。
VS Code 内置的源代码管理（SCM）视图不是 Git 的图形界面替代品，而是轻量、快捷的 Git 操作入口——它能完成日常 80% 的操作，但前提是理解它和命令行 Git 的映射关系，以及哪些操作它会自动帮你做、哪些必须手动干预。
Git 必须已安装且可被 VS Code 识别
VS Code 不自带 Git，它只是调用系统 PATH 中的 git 命令。如果 SCM 视图空白或提示“找不到 Git”，先验证：
- 终端中运行
git --version能正常输出版本号 - VS Code 设置中检查
git.path是否被错误覆盖（如指向了不存在的路径） - Windows 用户注意：若通过 Git for Windows 安装，确保勾选了“Run Git from the Windows Command Prompt”选项，否则 WSL 或 PowerShell 环境下可能不可见
文件状态变化如何触发自动追踪
VS Code 的 SCM 视图默认监听工作区根目录下的 .git 文件夹，并自动读取 git status 结果。但它不会主动扫描子模块或嵌套仓库——除非你把那个子目录单独打开为一个窗口。
- 新增未跟踪文件（Untracked）：出现在“CHANGES”下方的 Untracked 区域，右键可 Stage（即
git add） - 修改已跟踪文件：显示在 Changes 区，支持点击文件名查看行级差异（类似
git diff），也可右键 Stage/Revert - 忽略文件仍显示？检查
.gitignore是否写错路径（比如漏了/导致未生效），VS Code 不会高亮 ignore 错误，需靠git check-ignore -v filename排查
提交、推送、拉取的关键操作链路
VS Code 把 Git 工作流压缩成三步按钮，但背后逻辑和命令行完全一致，不能跳过中间状态：
- 点击 ✓ Commit 按钮前，必须先 Stage（否则提交为空）；输入框里写的是
git commit -m "xxx"的 message - 推送（Push）按钮仅在有上游分支（upstream）时可用；若首次推送，需先点“...” → “Push to Origin” 或手动执行
git push -u origin main - 拉取（Pull）本质是
git pull --ff-only（默认快进合并），若遇到冲突，VS Code 会停在“Merge Changes”界面，此时必须手动解决冲突并 Stage 修改后的文件，再点击 Commit 完成合并提交
分支切换与创建的隐藏限制
VS Code 的分支控件（左下角 Git 图标旁）显示当前分支，点击可快速切换，但它不支持直接从远程分支检出（git checkout -b local-name origin/feature）：
- 要基于远程分支新建本地分支：先“...” → “Create Branch”，输入名字后，在弹出的“Pick base”中选择对应
origin/xxx - 删除本地分支后，远程分支不会同步删除；想清理远端，必须手动运行
git push origin --delete branch-name - 分支名含斜杠（如
feat/login-ui）完全合法，VS Code 支持，但某些旧版 CI 配置可能解析异常，需留意部署侧兼容性
真正容易卡住的地方，往往不是功能找不到，而是 VS Code 隐式执行了 --ff-only 或自动 Stage，导致你以为“点了就完事”，结果 Push 失败或提交内容不对。建议关键操作前，顺手敲一行 git status 看一眼当前真实状态。
