vs code需系统预装git并正确配置路径才能使用源代码管理功能；未配置时显示“git not found”，须通过设置git.path指定绝对路径并重启vs code，macos用户还需注意gui应用不继承shell的path。
VS Code 本身不带 Git，必须先在系统里装好 Git 并让它能被 VS Code 找到，否则点“Source Control”图标只会看到“Git not found”或一堆灰色按钮。
确认系统已安装 Git 并可执行
这是所有问题的起点。VS Code 不会替你装 Git，也不会自动识别路径。
- 打开终端（macOS/Linux）或命令提示符/PowerShell（Windows），运行
git --version。如果报错或无输出，说明 Git 没装，或没加进系统 PATH - Windows 用户装 Git 时务必勾选 “Add Git to PATH”（默认是勾选的，但有人会取消）
- macOS 用户用 Homebrew 安装后，路径通常是
/opt/homebrew/bin/git（Apple Silicon）或/usr/local/bin/git（Intel），但 VS Code GUI 启动时可能不继承 shell 的 PATH，导致git --version在终端能跑，VS Code 里却找不到
让 VS Code 正确找到 git 可执行文件
VS Code 需要明确知道 git 命令在哪，否则 SCM 视图就是摆设。
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Git: Show Git Output回车，看输出面板第一行是不是类似Using git 2.43.0 from /opt/homebrew/bin/git - 如果显示
Git not found，就去设置里搜git.path，填入你本地git的绝对路径（例如 Windows 是C:\Program Files\Git\bin\git.exe，macOS 是/opt/homebrew/bin/git） - 改完设置后必须重启 VS Code——不是关掉终端、不是重开窗口，是彻底退出再启动
登录 GitHub 账户（非必需但强烈建议）
这步不决定 Git 能不能用，但影响后续克隆、推送、PR 关联等体验。
- VS Code 左下角点击头像图标 → Sign in to GitHub
- 选择浏览器登录，授权后 VS Code 就能自动读取你的 SSH 密钥或 token，避免每次
git push都输密码或 token - 注意：如果用 SSH 克隆（
git@github.com:user/repo.git），需提前配好 SSH key；如果用 HTTPS（https://github.com/user/repo.git），登录 GitHub 后 VS Code 会自动用 token 替代密码
初始化或克隆仓库前的最后检查
别急着点“Initialize Repository”或“Clone Repository”，先确认左侧 Source Control 图标旁有没有分支名（如 main 或 master）。
- 如果没有分支名，只显示 “SOURCE CONTROL” 标题且下方为空，大概率是 Git 还没识别成功
- 如果能看到分支名，但点开后文件列表是空的，检查当前打开的是否是**仓库根目录**（即包含
.git文件夹的那层） - 刚克隆完项目，VS Code 可能不会自动切换到该文件夹——它弹出“Open in New Window”后，你得手动点进去，否则 SCM 视图不激活
最常被忽略的是：Git 路径配置后不重启 VS Code，以及 macOS 下 shell 配置（如 ~/.zshrc）里的 PATH 没生效到 GUI 应用。这两点卡住的人最多，比拼写错误或网络问题还顽固。
