VSCode找不到Git导致SCM面板灰显，首要确认git --version在内置终端是否可用；若不可用，需安装Git并加入PATH，或手动配置"git.path"并完全重启VSCode。
VSCode 找不到 Git，SCM 面板灰显怎么办
VSCode 本身不带 Git，它只是调用你系统里装好的 git 可执行文件。面板灰、分支不显示、右下角没分支名——90% 是这一步卡住了。
先在 VSCode 内置终端（Ctrl + `）里运行：git --version。没输出或报错，说明终端 PATH 没继承到 git；有输出但 SCM 还是灰的，大概率是 VSCode GUI 启动时没拿到 PATH。
最稳的解法是手动指定路径：
- 按
Ctrl + Shift + P→ 输入Preferences: Open Settings (JSON) - 加这一行：
"git.path": "/usr/local/bin/git"（macOS Homebrew）或"git.path": "C:/Program Files/Git/bin/git.exe"（Windows） - 保存后**必须完全退出 VS Code（关掉所有窗口），再重开**，热重载不生效
注意：Windows 用户别填 cmd\git.exe，它缺 SSH 支持，推送到 GitHub/Gitee 会卡在认证。
点“+”图标没反应？你可能误解了 Stage 的行为
左侧 SCM 面板里每个文件旁的 + 图标，只对 Untracked（从未被 Git 追踪过）的文件有效。改了已追踪的文件、删了文件、重命名——它都不管。
真正想暂存「所有当前修改」，得这么做：
- 右键任意一个已修改的文件 →
Stage Changes - 或按
Ctrl + Shift + P→ 输入Git: Stage All - 想只暂存某几行？点开文件，在改动行右侧 hover 出
⋯→Revert Selected Ranges（撤销选中范围，即反向暂存）
别依赖那个 + 图标做日常暂存，它是为初始化场景设计的，不是万能 add。
提交信息写多行、自动签名、用模板怎么配
VSCode 提交框默认支持多行，直接换行就行，Ctrl + Enter 提交，不用鼠标点 ✔。
如果团队要求每条 commit 带 Signed-off-by，打开设置搜 git.alwaysSignOff，勾选即可，VSCode 会在每次提交末尾自动追加。
要强制用规范模板（比如含 Type:、Scope:、Description:）：
- 在项目根目录建
.gitmessage文件，写好模板内容 - 进项目终端运行：
git config commit.template .gitmessage - VSCode 会自动读取这个配置，下次打开提交框就预填充了
注意：这个配置只对当前仓库生效，--global 全局设模板容易和不同项目规范冲突，不推荐。
冲突解决时，“Accept Current Change”按钮容易点错
VSCode 默认把远端变更（Incoming）放左边，本地变更（Current）放右边。但按钮文字 Accept Current Change 在右侧——看起来像“接受右边”，其实它真就是“接受右边”，也就是丢弃远端、保留自己写的。
一不留神点错，自己的代码就没了。安全做法是：
- 先看清楚左右两边哪边是 Incoming（通常标着 “Incoming from ‘main’”）
- 点
Accept Incoming Change（左边按钮）来合并别人改的 - 点
Accept Current Change（右边按钮）来保留自己写的，覆盖别人的 - 不确定时，点
Accept Both Changes或手动编辑中间的冲突块
这个 UI 逻辑反直觉，是新手误操作高发区，别凭位置猜语义，一定读文字。
