VSCode源码控制是编码必备基础设施；文件不显示变更因未识别Git仓库；暂存无响应因二进制/大文件/diff异常；推送失败因未设置上游分支。
VSCode 的源码控制功能不是“锦上添花”，而是日常编码中无法绕开的基础设施——它把 Git 从命令行工具变成你写代码时呼吸般的自然延伸，省去频繁切换上下文、避免漏提交、误提交，尤其在多人协作和快速迭代场景下，缺了它，效率直接打五折。
为什么改完代码却看不到文件变绿？
常见现象：修改了 src/utils.ts，但源代码管理视图里没出现，状态栏也没提示。这不是功能失效，而是 VSCode 没识别到 Git 仓库。
- 确认项目根目录下存在
.git文件夹（不是.git/子目录，也不是被忽略的嵌套路径） - 若用多根工作区（multi-root workspace），VSCode 默认只激活第一个文件夹的 Git；需手动执行
Git: Add Repository添加其余仓库 - 检查设置：
git.enabled是否为true，且git.path指向有效的 Git 可执行文件（如/usr/bin/git或C:\Program Files\Git\bin\git.exe）
暂存时点了“+”却没反应？
点击文件前的 + 图标无响应，或部分更改无法单独暂存——本质是 VSCode 对该文件类型或变更粒度缺乏 diff 支持。
- 二进制文件（如图片、PDF）不支持行级暂存，只能全量暂存或丢弃
- 大文件（>50MB）可能被 Git 自动禁用 diff，导致 VSCode 无法生成差异视图，也就无法选择性暂存
- 确保文件编码一致：UTF-8 with BOM 和 UTF-8 混用会导致 diff 错乱，表现为“看起来没改却标红”
- 临时解决：右键文件 →
Stage Changes强制全量暂存；长期建议在.gitattributes中声明文本文件类型
提交后点推送却提示“no upstream branch”？
这是新手高频卡点：本地提交成功，但点击 ↑ 推送图标报错，因为分支尚未关联远程追踪分支。
- 首次推送必须显式建立上游：点击底部状态栏分支名 →
Publish Branch（而非仅点推送图标） - 等效命令行是
git push -u origin main，VSCode 就是帮你封装了-u参数 - 若已手动推过但未设上游，可在命令面板运行
Git: Set Upstream for Current Branch - 注意：重命名分支后，原上游链接会断开，需重新发布或手动
git branch --set-upstream-to=origin/new-name
冲突标记明明写了“
VSCode 冲突检测依赖 Git 的合并元数据，不是靠正则匹配字符串。如果手动编辑冲突标记却没触发 UI 提示，说明 Git 并未将该文件标记为“unmerged”。
- 不要手动添加/删除
<<<<<< HEAD等标记——它们应由git merge或git pull自动生成 - 若从别处复制粘贴了冲突内容，先执行
git status确认文件是否在 “Unmerged paths” 列表中 - VSCode 只对处于 Git 索引中“未合并”状态的文件启用三向合并编辑器；否则仅当作普通文本，需手动解决
- 修复方法：在终端运行
git checkout --conflict=diff3 -- .重置冲突状态，再重试
真正容易被忽略的，是 VSCode 的 Git 集成始终在“代理”本地 Git，它不会替你做决定，也不会掩盖底层逻辑。一旦遇到异常，第一反应不该是“VSCode 坏了”，而是打开内置终端敲 git status ——那个输出，才是真相的起点。
