先确认 Git 是否就位，VSCode 的 Git 功能依赖外部 git 可执行文件；Ctrl+Shift+G 无反应或提示“Git not found”，说明 VSCode 未识别 git，需在集成终端运行 git --version 验证，并检查 git.path 配置及 PATH 继承问题。
Ctrl+Shift+G 打不开源代码管理视图？先确认 Git 是否就位
VSCode 的 Git 功能完全依赖外部 git 可执行文件，快捷键失效往往不是快捷键问题，而是 Git 根本没被识别。按下 Ctrl+Shift+G（macOS 为 Cmd+Shift+G）后界面无反应或弹出“Git not found”，说明 VSCode 找不到 git。
- 在 VSCode 集成终端中运行
git --version：如果报错或无输出，系统级 Git 未安装或 PATH 异常 - 打开命令面板（
Ctrl+Shift+P），输入Git: Show Git Output：正常应显示类似Using git 2.41.0 from /usr/local/bin/git；若路径为空或报错，需手动配置git.path设置项 - macOS 用户特别注意：GUI 启动的 VSCode 不继承 shell 的
PATH，即使终端能用git，VSCode 也可能找不到——检查~/.zshrc中是否导出了 Homebrew 的 bin 路径（如export PATH="/opt/homebrew/bin:$PATH"），改完重启 VSCode
Ctrl+Enter 提交失败？检查暂存区和提交消息格式
Ctrl+Enter 是 SCM 视图中快速提交的默认快捷键，但它只对「已暂存」且「提交消息非空」的变更生效。常见失败场景不是快捷键失灵，而是前置条件不满足。
- 提交按钮（✔️）灰掉或
Ctrl+Enter无响应：确认至少有一个文件在 STAGED CHANGES 区域；未暂存的修改不会被提交 - 提示 “Please enter a commit message” 却无法提交：消息框必须有至少一个非空白字符；空格、换行符不算有效内容
- 提交后状态栏仍显示 “1 to sync”：说明本地 commit 已成功，但尚未推送；此时点击底部状态栏的同步箭头，或按
Ctrl+Shift+P运行Git: Push - 若启用了
git.commitTemplate，提交框会预填充模板内容，但光标不在首行时容易误删全部内容导致提交失败——建议手动输入前先清空再写
Ctrl+Shift+P 里搜不到 Git 命令？过滤词要精准
VSCode 命令面板的模糊匹配很强大，但搜 Git 相关操作时，关键词选错会导致结果不全或排在后面，浪费时间。
- 搜
checkout比搜switch更可靠：VSCode 内置命令名是Git: Checkout to...，不是Git: Switch Branch - 拉取并变基用
Pull (rebase)：直接搜pull会出现多个选项，选带(rebase)后缀的，避免git merge引入不必要的合并提交 - 对比当前文件与 HEAD：搜
Compare With HEAD，不是diff或compare——后者可能匹配到其他扩展功能 - 临时搁置更改（相当于
git stash）：搜Git: Stash，不是stash单独搜，否则可能优先显示插件命令
右键菜单里的 “Stage Selected Ranges” 不可用？编辑器状态必须满足
这个功能支持行级暂存，但非常依赖编辑器当前焦点和选区状态，稍有偏差就会禁用。
- 必须在已打开的、有 Git 跟踪的文件中操作；新建未保存的临时文件或未加入仓库的文件上右键无效
- 选区不能跨文件：只能在一个编辑器标签页内选择，且不能包含折叠区域（比如被
// #region折叠的代码块） - 选中后右键，菜单项是灰色的？确认该文件当前处于 “Modified” 状态（即工作区有未暂存改动）；如果已全部暂存或已提交，此选项不出现
- 部分语言扩展（如 Prettier）可能在保存时自动格式化，导致选区边界变化，建议暂存前关闭自动保存，或手动触发格式化后再选
git reset 后，SCM 视图有时不会实时刷新，需要手动点击视图右上角的刷新按钮（↻），或按 Ctrl+Shift+G 重新聚焦才能同步状态。 
