VS Code 提交代码需先配置 Git 路径和用户信息，否则提交按钮不可用；提交仅执行 git commit，需手动同步（git push）才能推送到远程仓库。
VS Code 提交代码到 Git 不是点一下“✓”就完事——它只做 git commit，不自动 git push；没配 git.path 或用户信息，连按钮都点不动。
VS Code 找不到 git 命令？先查路径再填设置
点提交没反应、SCM 面板空白、右下角不显示分支名，90% 是 VS Code 根本没连上系统 Git。它不自带 Git，只调用外部可执行文件。
- 在系统终端（不是 VS Code 内置终端）运行
which git（macOS/Linux）或where git（Windows），拿到真实路径，比如/usr/local/bin/git或C:\Program Files\Git\bin\git.exe - VS Code 里按
Ctrl+Shift+P→ 输入Preferences: Open Settings (UI)→ 搜索git.path→ 粘贴上面的完整路径 - 必须彻底退出 VS Code（不是“重新加载窗口”），再打开，否则设置不生效
- 验证：按
Ctrl+Shift+P→ 运行Git: Show Git Output，第一行应显示类似Using git 2.40.1 from /usr/local/bin/git
提交前必须设 user.name 和 user.email
不配置就会卡在 please tell me who you are，这是 Git 的硬性要求，和 VS Code 无关。
Conventional Git
下载
Conventional Commits v1.0.0 分支、工作树命名及提交信息规范，适用于 GitHub 与 GitLab 项目，用于创建分支和命名工作树等场景。
- 推荐在 VS Code 设置里搜
git.user，直接填user.name和user.email字段，保存即生效 - 命令行方式：在任意目录运行
git config --global user.name "YourName"和git config --global user.email "you@example.com" - 注意：邮箱必须和 GitHub/Gitee 账号注册邮箱一致，否则提交记录不会关联到你的主页
- 公司项目建议在项目根目录用
--local覆盖全局配置，避免混用
文件右键“Stage Changes”变灰或没反应
不是功能坏了，是文件没被 Git 跟踪，或者被 .gitignore 拦住了。
- 新文件默认是“未跟踪（untracked）”状态，VS Code 不会自动
git add，必须手动 Stage - 检查
.gitignore是否误写规则，比如node_modules（少斜杠）可能匹配到项目名，而正确写法是node_modules/ - 某些语言服务生成的缓存目录（如
__pycache__/、.mypy_cache/）常被忽略，右键自然不可用 - 整个文件夹都变灰？确认你打开的是 Git 仓库根目录——资源管理器顶部路径里必须有
.git文件夹
点了 ✓ 却没上远程？同步不是自动发生的
VS Code 的“提交”只是 git commit，仅存本地；“同步更改”按钮才触发 git push，但前提是远程已绑定。
- 右下角分支名旁的云图标：灰色 = 无未推送提交，蓝色 + ↑数字 = 有本地提交未推送到远程
- 首次推送前，必须先运行
git remote add origin https://github.com/user/repo.git（HTTPS）或git remote add origin git@github.com:user/repo.git（SSH） - 如果报
fatal: no upstream branch，说明本地分支还没和远程绑定，需用git push -u origin main（注意是main，不是master） - 点击右下角云图标或“同步更改”按钮，实际执行的是
git pull --rebase && git push，不是单向推送
真正容易被忽略的是：VS Code 的图形操作背后全是标准 Git 命令，它不帮你绕过任何基础约束——路径、身份、暂存、上游分支，缺一不可。调试时别只盯着界面，随时切到终端跑 git status，比猜快得多。
