VSCode提示“git not found”是因未找到Git路径，需在设置中配置git.path；SCM空白多因工作区非Git根目录；提交失败常因用户信息未配置；拉取推送失败多因凭据或代理问题。
Git命令未找到：VSCode提示“git not found”
VSCode 无法调用 Git，通常是因为它没找到系统安装的 git 可执行文件路径。不是 Git 没装，而是 VSCode 没“看见”它。
- 在终端运行
which git（macOS/Linux）或where git（Windows CMD）确认 Git 安装位置，比如/usr/local/bin/git或C:\Program Files\Git\bin\git.exe - 打开 VSCode 设置（
Cmd+,或Ctrl+,），搜索git.path，填入上面查到的完整路径（注意 Windows 上推荐用git.exe而非git.cmd） - 如果使用 GitHub CLI 或自定义 Git 构建（如
git-lfs增强版），确保该路径下git --version能正常输出，否则 VSCode 会静默禁用 Git 集成
源代码管理视图空白或不刷新
左侧 SCM 栏无文件列表、无变更状态、点击“+”没反应——大概率是工作区根目录没识别为 Git 仓库，或 Git 仓库嵌套结构异常。
- 检查当前打开的文件夹是否包含
.git目录（不是子文件夹里有，而是**该文件夹本身**是 Git 工作树根） - 若使用多根工作区（workspace file），每个文件夹需独立含
.git；VSCode 不支持跨根仓库聚合显示 - 运行
git status手动验证是否能正常执行；如果卡住或报错fatal: detected dubious ownership，说明 Git 拒绝读取该仓库（常见于 Linux/macOS 权限变更后），需执行git config --global --add safe.directory "*"
提交失败：提示“Please tell me who you are”或“empty commit message”
VSCode 提交按钮灰掉、弹窗无响应，或点击后报错，本质是 Git 用户信息缺失或编辑器未正确触发提交流程。
- VSCode 不会自动读取系统级
~/.gitconfig的[user]配置，尤其在 macOS 使用 Rosetta 或某些容器化终端时；务必在项目根目录运行：git config user.name "Your Name" git config user.email "you@example.com"
- 如果使用 VSCode 内置编辑器写提交信息，保存并关闭文件（
Cmd+S+Cmd+W）才会触发提交；仅关闭标签页不保存，VSCode 会丢弃输入 - 若配置了
commit.template，且模板路径无效或不可读，VSCode 提交界面可能直接崩溃或无限加载；临时注释掉该配置可验证
拉取/推送超时或认证失败（尤其 HTTPS 协议）
点击同步按钮后长时间转圈、弹出空认证框、或报错 Authentication failed，多数与凭据管理器或代理设置有关。
- HTTPS 协议下，VSCode 依赖系统凭据存储（macOS Keychain / Windows Credential Manager / Linux libsecret）。若之前用过错误账号，旧凭据会持续干扰；可在系统凭据管理器中删除所有含
git:或github.com的条目再重试 - 公司网络常用 HTTP 代理，但 VSCode Git 集成默认不继承
http.proxy设置；需单独配置：git config --global http.proxy http://proxy.company.com:8080
- GitHub 自 2021 年起禁用密码认证，必须用 Personal Access Token（PAT）代替。Token 需勾选
repo权限，且在 VSCode 中首次拉取时粘贴整个 token（用户名任意，密码栏填 token）
