vs code 内置 git 支持需先安装系统级 git 命令行工具并确保路径正确，否则源代码管理视图、分支显示、提交功能全部失效；提交前必须手动暂存文件并填写提交信息；推送失败多因远程 url 类型（https/ssh）与认证方式不匹配；切换分支前须确保工作树干净或使用 git stash 暂存未提交更改。
VS Code 内置 Git 支持是开箱即用的，但默认不自动启用——必须先装好 Git 命令行工具，且 VS Code 能正确找到它，否则所有 Git 图标、状态栏、提交按钮全都不显示，连 Ctrl+Shift+G 都打不开源代码管理视图。
Git 命令行没装或路径没配对，VS Code 的 Git 就是摆设
VS Code 本身不含 Git 引擎，它只是调用你系统里安装的 git 命令。常见现象包括：
- 点击左下角分支名无反应，状态栏不显示分支信息
-
Ctrl+Shift+G打开后一片空白，“初始化仓库”按钮灰掉 - 终端里运行
git --version报错，或 VS Code 内置终端提示command not found: git
解决办法只有两个关键动作：
- 去 git-scm.cn 下载安装 Git（Windows 用户选 “Use Git from Windows Command Prompt” 选项，避免后期路径问题）
- 安装完重启 VS Code；如果仍不识别，进 VS Code 设置搜
git.path，手动填入git可执行文件路径，例如C:\Program Files\Git\bin\git.exe
提交前必须做两件事：暂存 + 写提交信息
很多人点完 √ 按钮没反应，其实是漏了“暂存”这步。VS Code 不像命令行能 git commit -a 自动暂存所有修改，它严格区分“已修改”和“已暂存”状态。
GitHub Trending Feed
下载
获取 GitHub Trending 热门仓库列表。当用户要求查看 GitHub 热榜、每日 GitHub trending、推送 GitHub 热门项目时使用。支持可选语言过滤，返回结构化 JSON 由 agent 自行决定输出格式。
- 文件列表里显示“已修改”，但没勾选前面的复选框 → 它不会进入下一次提交
- 点了
√却没在顶部消息框里输入内容 → 提交直接被拒绝，无提示、无报错，就像点了空气 - 建议写提交信息时用约定式提交，比如
feat: add login button或fix: prevent null ref in api handler，后续看历史更清晰
推送失败？大概率是远程 URL 或认证方式不匹配
点击“同步更改”或执行 Git: Push 后卡住、弹出登录框、或报错 Authentication failed，不是网络问题，而是远程仓库地址类型和本地配置不一致。
- 如果你用 HTTPS 地址（
https://github.com/user/repo.git），就得每次输账号密码（或配 GitHub Token） - 如果你用 SSH 地址（
git@github.com:user/repo.git），就必须提前生成并添加过id_ed25519.pub到 GitHub 的 SSH 设置里 - 检查当前远程地址：终端进项目根目录，运行
git remote get-url origin；不对就删掉重加：git remote remove origin→git remote add origin git@github.com:user/repo.git
分支切换后文件没变？别急着重装插件，先看工作树是否干净
切换分支后，编辑器里代码还是旧的，或者某些文件突然变成“已修改”状态，往往不是 VS Code bug，而是当前工作区有未提交变更或未处理的冲突残留。
- 切换前务必确认“源代码管理”面板里没有带
U（Untracked）、M（Modified）或??状态的文件 - 如果有，要么
git add && git commit提交，要么git checkout -- <file></file>丢弃修改，否则 Git 会阻止切换（报错error: Your local changes to the following files would be overwritten by checkout） - 真要保留未提交改动又切分支？用
git stash暂存，切完再git stash pop—— VS Code 的命令面板里搜 “Git: Stash” 就能操作
Git 在 VS Code 里不是黑盒，它的所有操作都映射到真实命令行行为。界面点一下，背后就是一次 git add、一次 git commit、一次 git push。理解这个前提，才能快速定位“为什么点不动”“为什么推不上”“为什么切不了分支”——问题不在 UI，在你本地 Git 的状态是否干净、配置是否闭环。
