VSCode 自带 Git 集成但依赖系统 Git 安装与 PATH 配置，需确保 git --version 可执行、打开含 .git 的根目录、正确配置远程凭证（PAT 或 SSH），否则提示“Git not found”或认证失败。
VSCode 自带 Git 集成，不需要额外安装插件就能用，但必须确保系统已安装 Git 并在终端中可用——否则 VSCode 会提示 Git not found 或无法识别仓库。
确认 Git 是否已正确安装并被 VSCode 识别
VSCode 不会自己装 Git，它依赖系统 PATH 中的 git 命令。常见失败原因不是 VSCode 设置问题，而是 Git 没装、没加进环境变量，或装了但路径不对。
- 在终端（macOS/Linux）或命令提示符/PowerShell（Windows）中运行
git --version，有输出说明已安装 - 在 VSCode 中按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Git: Show Git Output，看底部面板是否报错Failed to execute git - 如果报错，打开 VSCode 设置（
Ctrl+,），搜索git.path，手动设置为你的git可执行文件路径，例如：/usr/bin/git（macOS）、C:\Program Files\Git\bin\git.exe（Windows）
初始化本地仓库或打开已有 Git 项目
VSCode 的 Git 功能只在「已识别为 Git 仓库」的文件夹中激活。它不会自动初始化仓库，也不会扫描子目录找 .git —— 必须打开的是仓库根目录（即包含 .git/ 文件夹的目录）。
- 新建项目：先在终端进入项目目录，运行
git init，再用 VSCode 打开该目录（code .） - 已有项目：直接用 VSCode 打开含
.git/的文件夹；如果打开后左下角没显示分支名（如main），说明 VSCode 没检测到 Git 仓库 - 右键资源管理器中的文件夹 →
Reveal in Explorer→ 确认里面真有.git文件夹（隐藏的），没有就不是 Git 仓库
日常操作：提交、暂存、推送都在侧边栏完成
左侧活动栏点击源代码管理图标（^ 图标），即可看到变更文件列表。VSCode 把 Git 操作做了图形化收敛，但底层仍是标准 Git 命令，行为完全一致。
- 修改文件后，它自动出现在
CHANGES区域；点击文件左侧的+号可暂存（git add） - 暂存区文件支持右键 →
Stage Selected Ranges，只提交部分选中行（对应git add -p） - 输入提交信息后按
Ctrl+Enter提交（等价于git commit -m "xxx"） - 点击右上角同步按钮（两个箭头图标）会先
git pull再git push；若需单独拉取或推送，右键分支名选择对应操作
遇到“Unable to fetch”或“Authentication failed”怎么办
这类错误基本都和凭证有关，VSCode 本身不处理账号密码，完全复用系统 Git 的凭证管理机制。GitHub、GitLab 等平台停用密码登录后，这个环节最容易卡住。
- 检查远程地址是否为 HTTPS 形式（
https://github.com/user/repo.git）：如果是，必须用 Personal Access Token（PAT）代替密码 - 运行
git remote set-url origin https://<your-token>@github.com/user/repo.git</your-token>（不推荐长期明文 token） - 更稳妥方式：配置 Git 凭据助手，比如 macOS 用
git config --global credential.helper osxkeychain，Windows 用git config --global credential.helper manager，然后首次 push 时填 token 即可保存 - 如果用 SSH，确保
origin是git@github.com:user/repo.git格式，并且ssh -T git@github.com能通
Git 集成本身很轻量，但出问题时往往卡在环境链路（Git 安装 → PATH → 凭据 → 远程 URL 类型），而不是 VSCode 设置。盯着左下角分支名和源代码管理面板是否亮起，比翻设置项更快定位根源。
