VS Code Git用不了，八成是未安装Git或系统PATH未配置；需先在系统终端运行git --version验证，若失败则安装Git并确保PATH包含其路径，再重启VSCode。
VS Code 里 Git 用不了？八成是没装 Git 本身，或者 PATH 没通 —— VS Code 不自带 Git，它只是个“遥控器”，底层必须有 git.exe（Windows）或 /usr/bin/git（macOS/Linux）在系统路径里。
git --version 报 command not found 怎么办
这是最常见卡点，不是 VS Code 问题，是系统找不到 git 命令。
- 先在系统终端（不是 VS Code 终端）里运行
git --version：如果报错，说明 Git 没装，或装了但没加进系统 PATH - Windows 用户安装时，务必选
Git from the command line and also from 3rd-party software，别选 “only from Git Bash” - Mac 用户若用
xcode-select --install安装失败，改用brew install git更稳 - 装完后重启 VS Code（不是只关终端），否则它不会重新扫描 PATH
VS Code 左下角不显示分支名，Source Control 面板灰掉
说明 VS Code 检测到当前文件夹不是 Git 仓库，或 .git 目录损坏/被误删。
Lovefromio Github
下载
使用 `gh` CLI 与 GitHub 交互。通过`gh issue`、`gh pr`、`gh run` 和 `gh api` 管理 issue、PR、CI 运行以及高级查询。
- 确认你打开的是项目**文件夹根目录**，不是子文件夹 ——
git init必须在想管理的顶层目录执行 - 手动检查有没有
.git文件夹（默认隐藏，需开启“显示隐藏文件”）；没有就补执行git init - 如果
.git存在但 VS Code 仍不识别，试试在 VS Code 终端里运行git status：报错“not a git repository”说明路径不对，报错“fatal: not in a git directory”说明 .git 损坏，删掉重git init
点了 Commit 却弹出 COMMIT_EDITMSG 文件
这不是 bug，是 Git 在等你写提交信息 —— VS Code 默认把空提交当无效操作，强制你填描述。
- 直接在弹出的
COMMIT_EDITMSG编辑器第一行输入英文简述（如feat: add login button），保存关闭即可完成提交 - 不想每次弹窗？在 VS Code 设置里搜
git.defaultCommitMessage，设为""或填模板字符串，但不推荐新手跳过写消息这步 - 注意：中文路径、含空格的路径、未保存的文件都可能导致提交失败，先确保所有待提交文件已保存
push 时反复要输密码，SSH 配置总失败
GitHub/GitLab 现在默认禁用密码登录，必须走 SSH 或 Personal Access Token（PAT），而 SSH 配置最容易卡在公钥复制环节。
- 生成密钥用
ssh-keygen -t ed25519 -C "your_email@example.com"，连按三次回车，别设密码（否则每次 push 都要输） - 复制公钥别用鼠标拖 —— 运行
cat ~/.ssh/id_ed25519.pub | clip（Windows）或pbcopy < ~/.ssh/id_ed25519.pub（macOS） - 粘贴到 GitHub Settings → SSH and GPG keys 时，**不能有多余空格、换行、前后引号**，开头是
ssh-ed25519 AAAA...，结尾是邮箱 - 测试命令是
ssh -T git@github.com，看到Hi xxx! You've successfully authenticated...才算通
真正容易被忽略的点是：VS Code 的 Source Control 面板只反映当前工作区的状态，但它背后依赖的是系统级 Git 可执行文件 + 项目级 .git 目录 + 远程仓库的认证状态。三者任一断链，操作就会静默失败或半途卡住 —— 别急着重装插件，先用终端跑一句 git status 和 git remote -v 看清底层到底卡在哪。
