先确认终端里能不能跑出git --version，如果不行，得先装 Git 并把它的路径加到PATH里；如果终端能用但 VS Code 不认，那就要看你是从哪个入口启动的 VS Code——macOS 上得用code .命令从终端启动，Windows 安装时记得勾选 “Add to PATH”，或者直接在设置里把git.path配成绝对路径，然后重启。
VS Code 找不到 git 命令怎么办
大多数“Git 罢工”的案例，根子都在同一个地方：VS Code 启动的时候，压根没加载到系统的 git 可执行文件。它本身不内置 Git，全靠调用外部命令干活。
先做个简单排查：在终端里敲一下 git --version，如果能正常输出版本号，说明系统级的 Git 已经装好了；如果不行，那就得先去把 Git 装好，并确保它进了系统的 PATH 环境变量。
如果终端里能用，但 VS Code 里死活不认，那问题多半出在启动方式上：
- macOS 用户：从 GUI 启动的 VS Code 并不会继承终端 shell 的
PATH配置。你需要检查~/.zshrc或对应的 shell 配置文件，确认是否导出了正确路径，比如export PATH="/opt/homebrew/bin:$PATH"。改完配置后，记得重启 VS Code。 - Windows 用户：安装 Git for Windows 时，如果没勾选 “Run Git from the Windows Command Prompt”，那么即使 PowerShell 或 WSL 能用，VS Code 也识别不到。重装一下 Git，注意勾选这个选项就行。
- 手动指定路径：如果以上都不行，可以在 VS Code 设置里搜索
git.path，直接把 Git 的绝对路径填进去，比如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 会高亮冲突文件，但不会自动打开合并编辑器。你需要双击那个文件，在编辑器里手动处理<<<<、====、>>>>标记，然后右键选择“Accept Current Change”等操作。- 本地分支与远程分支偏离太多：当右下角显示 ↑2 ↓3 这样的标记时，强行点 Sync 很可能会被拒绝。正确的做法是先执行
Git: Pull (rebase)来整理本地历史，然后再推送。
有一个细节特别容易被忽略：VS Code 不会自动 stash 未提交的更改。当你切换分支或拉取代码时，如果还有未暂存或未提交的修改，它不会提醒你保存或暂存，而是直接报错退出。这个行为其实和命令行一致，但图形界面容易让人误以为“点一下就能切过去”。
