先确认终端中git --version是否正常；若否，需安装git并配置path；若是，则检查vs code启动方式（macos需终端执行code .，windows需安装时勾选“add to path”），或手动在设置中配置git.path绝对路径并重启。
VS Code 找不到 git 命令怎么办
绝大多数“Git 不工作”问题，根源是 VS Code 启动时没加载到系统 git 可执行文件。它不自带 Git，只调用外部命令。
先在终端里运行 git --version，确认能正常输出版本号；如果不行，说明系统级 Git 没装好或没进 PATH。
如果终端能用但 VS Code 不能用，常见原因有：
- macOS 用户：GUI 启动的 VS Code 没继承 shell 的
PATH，需检查~/.zshrc（或对应配置）是否导出正确路径，比如export PATH="/opt/homebrew/bin:$PATH"，改完重启 VS Code - Windows 用户：安装 Git for Windows 时没勾选 “Run Git from the Windows Command Prompt”，导致 PowerShell/WSL 可用但 VS Code 不识别
- 手动指定路径：设置中搜索
git.path，填入绝对路径，例如C:\Program Files\Git\bin\git.exe或/usr/local/bin/git
初始化仓库后看不到 SCM 视图变化
点击左侧源代码管理图标（分支图标）没反应，或始终显示“暂无源代码管理提供程序”，大概率是工作区没打开对——VS Code 只监听当前打开的**文件夹根目录**下的 .git 文件夹。
注意以下几点：
- 必须用“文件 → 打开文件夹”打开项目根目录，不能只打开单个文件或子目录
- 如果项目里有嵌套 Git 仓库（比如
submodule），VS Code 默认不识别，得单独打开那个子目录窗口 - 初始化后没立刻刷新？按
Ctrl+Shift+P输入Git: Refresh强制重载状态 - 检查
.git文件夹是否真生成了：它应该在你打开的文件夹根目录下，不可见但存在
git.commitTemplate 不生效怎么配
VS Code 默认不读取 commit 模板，即使你在 .git/config 里写了 commit.template，也得确保路径正确且可读。
实操要点：
- 模板文件路径必须是**绝对路径**（VS Code 不支持相对路径），例如
commit.template=/Users/you/project/.commit_template - 文件需存在且有读权限；内容可以是多行文本，含占位符如
# Subject、# Body - 配置位置：写在项目级
.git/config（推荐）或全局~/.gitconfig，不要写在 VS Code 设置里 - 改完后不用重启，下次点提交框就会自动填充模板内容
同步按钮（Sync Changes）点下去却没推送成功
顶部那个双向箭头看似一键同步，实际执行的是 git pull --rebase && git push，中间任一环节失败就停住，不会自动跳过。
常见卡点：
- 首次推送时没设上游分支：VS Code 会弹窗提示“Set upstream branch”，选“Push with upstream”即可，等价于
git push -u origin main -
pull --rebase遇到冲突：VS Code 会高亮冲突文件，但不会自动打开合并编辑器；必须双击该文件，在编辑器里手动处理/<code>====/>>>>标记，再右键选 “Accept Current Change” 等操作 - 本地分支与远程偏离太多：右下角显示 ↑2 ↓3 时，强行点 Sync 可能被拒绝；应先
Git: Pull (rebase)解决本地历史，再 Push
真正容易被忽略的是：VS Code 从不自动 stash 未提交更改。切换分支或拉取前，如果有未暂存/未提交的修改，它不会提醒你保存或暂存，而是直接报错退出——这个行为和命令行一致，但图形界面让人误以为“点一下就能切”。
