VSCode源代码管理不显示文件变动，根本原因是Git未正确集成：一是Git未安装或未加入系统PATH，导致终端执行git --version无输出；二是项目目录下缺少.git文件夹，未初始化仓库；三是全局user.name和user.email未配置，提交按钮变灰；四是VSCode打开的不是含.git的根目录，而是子文件夹。
VSCode 能直接用 Git，但必须满足三个硬性前提：Git 已安装且在系统 PATH 中、项目目录下存在 .git 文件夹、全局 user.name 和 user.email 已配置。缺一不可，否则源代码管理视图（Ctrl+Shift+G）会灰显或报错。
为什么 VSCode 的源代码管理视图不显示文件变动？
常见现象是修改了文件，左侧资源管理器没反应，源代码管理视图空空如也，或提示 “未启用源代码管理”。
- 最常踩的坑是：Git 没装，或装了但没勾选 “Add Git to the system PATH environment”（Windows 安装时默认不勾选）；可在 VSCode 终端执行
git --version验证，无输出即失败 - 项目目录未初始化为仓库：必须先运行
git init或通过 VSCode 命令面板执行Git: Initialize Repository，否则 VSCode 不识别为 Git 工作区 - 全局用户信息缺失：VSCode 提交按钮会变灰，终端执行
git config --global --list看不到user.name和user.email就要补上 - VSCode 打开的不是项目根目录：比如你打开的是子文件夹，而
.git在上级目录——它不会向上查找，必须重新用 VSCode 打开含.git的那个文件夹
如何让 VSCode 终端正确调用 Git 命令？
VSCode 集成终端本质是调用系统 shell（PowerShell / bash / zsh），再由 shell 找到 git 可执行文件。路径不对，命令就失效。
- 安装 Git 时务必勾选 “Git from the command line and also from 3rd-party software”，否则 Windows 下 Git 不进 PATH
- 若已安装但终端仍报
command not found: git，手动在 VSCode 设置中指定路径：git.path设为类似"C:\Program Files\Git\bin\git.exe"（Windows）或/usr/local/bin/git（macOS） - 不要强行改终端默认 profile 为 cmd —— cmd 对 Git 的兼容性差，尤其在处理换行、颜色输出时容易乱码；推荐用
Git Bash（Windows）或zsh（macOS） - 每次切换项目后，终端自动继承当前工作区路径，所以
git status不用 cd，直接输就行
VSCode 图形界面操作和终端命令怎么对应？
图形界面点几下，背后就是标准 Git 命令。知道对应关系，才能理解行为、排查问题、处理界面做不到的操作（比如强制回退、重写历史）。
- 点击文件旁的 “+” → 执行
git add <file>；点顶部 “+ All” →git add . - 输入提交信息后点对勾 →
git commit -m "xxx"；如果勾选 “Amend previous commit”，等价于git commit --amend - 底部状态栏点分支名 → 弹出菜单里选分支，本质是
git checkout <branch>或git switch <branch> - 右键某次提交 → “Revert Commit” → 背后是
git revert <commit-hash>，生成新提交来抵消旧变更；而 “Reset Commit” 是危险操作，对应git reset --hard <commit-hash>，会丢弃后续所有提交
为什么推送（push）总失败？关键卡点在哪？
推送失败不是 VSCode 的锅，而是远程仓库认证或权限链断了。图形界面只暴露“推送”按钮，不告诉你具体拦在哪一步。
- 首次推送前没设 remote：VSCode 不会自动帮你配
origin，必须先在终端运行git remote add origin https://github.com/user/repo.git（HTTPS）或git remote add origin git@github.com:user/repo.git（SSH） - HTTPS 方式每次 push 都要输账号密码？说明没配凭据管理器 —— 安装 Git 时必须勾选 “Git Credential Manager”，它会缓存登录态；否则只能切 SSH 方式
- SSH 方式失败？检查公钥是否已加到 GitHub/GitLab/Azure DevOps；终端执行
ssh -T git@github.com应返回 “Hi xxx!”；若提示 “Permission denied”，大概率是私钥没被 agent 加载，需运行ssh-add ~/.ssh/id_ed25519 - 推送被拒（rejected）？常见于远程有你本地没有的提交，此时不能直接 push，得先
git pull --rebase整合，再 push
真正容易被忽略的，是 VSCode 的 Git 集成其实有两个独立状态层：一个是终端里 git 进程的实际执行结果，另一个是 UI 视图的缓存快照。有时候终端里 git pull 成功了，但源代码管理视图还显示旧的冲突标记——这时候关掉再重开 VSCode，或者按 Ctrl+Shift+P 输入 Git: Refresh，比瞎点刷新图标管用得多。
