VSCode本身不执行提交，仅调用系统git命令；若找不到git，需在系统终端查which git或where git，填入设置git.path并彻底重启VSCode验证。
VSCode 本身不执行提交，它只是调用系统 git 命令；点一下 ✓ 不代表成功，漏掉暂存或消息为空就会静默失败。
VSCode 找不到 git 命令怎么办
根本原因不是没装 Git，而是 VSCode 没拿到它的路径——GUI 启动时通常不继承 shell 的 PATH，尤其 macOS 和 Windows。
- 先在系统终端（不是 VS Code 内置终端）运行
git --version，确认命令行可用；不行就重装 Git 或检查环境变量 - 再运行
which git（macOS/Linux）或where git（Windows），记下完整路径，比如/opt/homebrew/bin/git或C:\Program Files\Git\cmd\git.exe - 在 VSCode 中按
Ctrl+Shift+P→ 输入Preferences: Open Settings (UI)→ 搜索git.path→ 粘贴上面的路径 - 必须彻底退出 VSCode（不是“重新加载窗口”），再重启，否则设置不生效
- 验证：按
Ctrl+Shift+P→ 运行Git: Show Git Output，第一行应显示Using git X.X.X from /path/to/git
提交前必须手动 Stage 文件
VSCode 默认只提交“已暂存”的文件，新增、修改、删除都不会自动进入暂存区——图形界面里没有 “add” 按钮，但行为完全等价于 git add。
Git Changelog Generator
下载
使用约定式提交（Conventional Commits）从 Git 历史记录中生成结构化变更日志，支持多种格式、AI 增强型描述以及可自定义的范围……
- 新增文件（图标为蓝色
A）默认未暂存，右键选Stage Changes，或点文件旁的+号 - 修改文件（
M）编辑后仍是“已修改”状态，必须手动Stage Changes才算进暂存区 - 想只提交部分改动？选中几行 → 右键 →
Stage Selected Ranges，这相当于git add -p - 删除文件（
D）后，Stage Changes=git rm；若只想删工作区保留仓库版本，选Discard Changes
Commit 消息不能为空，且不能只写“update”
VSCode 不校验消息内容，但空消息会直接失败，且无任何提示——你点了 ✓，SCM 面板清空了，但实际什么都没发生。
- 提交框必须输入非空文本，哪怕写
chore: init repo也比留空强 - 建议用规范格式，如
fix: login button misaligned on iOS，方便后续筛选和自动化 - 按
Ctrl+Enter（Win/Linux）或Cmd+Enter（macOS）触发提交，仅点 ✓ 按钮有时响应滞后 - 提交后看右下角分支名旁是否有
↑1：有说明本地有未推送的 commit，此时还得点Sync Changes
Sync Changes 按钮到底做了什么
它不是单向推送，而是 git pull + git push 的组合操作——如果远程有新提交，它会先尝试合并，失败则卡住并报 rejected non-fast-forward。
- 同步前务必确保“Changes”列表为空，否则可能因冲突中断
- 若提示
Your local changes would be overwritten，说明有未暂存修改，要么先Stage，要么用Stash Changes临时藏起 - 首次推送到 GitHub 时，VSCode 会引导你登录并选择远程仓库；之后所有推送都走这个按钮，无需再配
origin - 注意：它不会自动创建远程分支，第一次 push 需带
-u参数（VSCode 内部已封装，只要目标远程存在即可）
最容易被忽略的是：VSCode 的暂存区是独立于命令行的，你在终端执行 git status 看到的状态，未必和 SCM 面板一致——因为面板只读取当前打开文件夹下的 .git，而终端可能在子目录或父目录运行。操作前先确认当前工作区根目录就是仓库根目录。
