Git未识别需检查PATH配置并重启VS Code；SCM面板空白因仓库未初始化或路径错误；“撤消更改”不处理已暂存文件；reset --hard不可逆，应先建备份分支。
Git 未识别为命令：VS Code 终端里 git 报错“command not found”
VS Code 默认用系统 shell，但 Git 可能没加进环境变量，或者安装时没勾选“Add Git to PATH”。终端里能运行 git --version，不代表 VS Code 能看到它。
- Windows 用户检查安装 Git 时是否勾选了
Add Git to the system PATH for all users（推荐选这个）；若已安装，重启 VS Code（不是仅关闭终端）才能刷新环境变量 - macOS 用户如果用 Homebrew 安装，确认
/opt/homebrew/bin（Apple Silicon）或/usr/local/bin（Intel）在$PATH中；VS Code 从 Dock 启动时可能不读 shell 配置，改用code .命令启动可继承当前终端环境 - Linux 用户检查
which git输出路径，把对应目录加进~/.profile或~/.bashrc的PATH里，再重载配置或重启 VS Code
源代码管理面板空白 / 不显示暂存区：Git 仓库未正确初始化或路径不对
VS Code 的源代码管理（SCM）面板依赖工作区根目录下存在 .git 文件夹。它不会自动向上查找父目录的仓库，也不会识别子文件夹里独立的 Git 仓库（除非你把那个子文件夹单独打开为工作区）。
- 确认当前打开的文件夹是 Git 仓库根目录：终端执行
git rev-parse --show-toplevel，输出路径应与 VS Code 左下角显示的文件夹路径一致 - 如果只是新建项目，别忘了手动运行
git init，否则 SCM 面板始终为空——VS Code 不会替你初始化仓库 - 多根工作区（workspace）中，每个文件夹需各自是 Git 仓库；混合普通文件夹和 Git 文件夹时，非 Git 文件夹的改动不会出现在 SCM 面板
点击“撤消更改”后文件恢复失败：VS Code 的撤销只作用于工作区，不等于 git checkout --
右键文件 → “撤消更改”，本质是丢弃工作区修改，等价于 git restore （Git 2.23+）或 git checkout -- （旧版）。但它**不处理已 git add 进暂存区的变更**。
- 如果文件已暂存（出现在“STAGED CHANGES”里），点“撤消更改”无效；必须先在暂存区右键 → “放弃暂存”，再对工作区执行“撤消更改”
- 想一步清空工作区 + 暂存区所有修改？终端运行
git restore .（全部）或git restore --staged .（仅暂存） - 注意：VS Code 的“撤消更改”不支持撤销到某次提交，那是
git reset或git checkout的事--
回退到某次提交后丢失新提交：误用 git reset --hard 且未备份引用
在 VS Code 的提交历史视图中点击“Reset branch to here”，默认是 --hard 模式。它会同时移动 HEAD、暂存区和工作区，**不可逆地丢弃之后的所有提交**，除非你还记得 SHA 或能在 git reflog 里找回。
- 安全做法：先用
git reset --soft（只移 HEAD，保留暂存和工作区），确认无误再二次操作；VS Code 不提供软重置选项，必须进终端 - VS Code 提交图右侧的“…”菜单里，“Revert commit”更安全——它生成一个反向提交，不破坏历史线性
- 执行
reset --hard前，建议先建临时分支：git branch backup-before-reset，几秒的事，救急时很关键
Git 的“撤消”能力全靠引用指针（HEAD、branch、reflog）撑着，一旦这些指针被覆盖又没留下线索，就真没了。很多人卡在以为 VS Code 界面操作是“安全沙盒”，其实它调的都是底层命令，该丢的数据一点不含糊。
