Git Graph 插件无响应需先确认仓库根目录和 Git 路径配置；分支不显示需启用 Remote Branches 或 Reflog；merge/rebase 灰显取决于提交上下文与工作区状态；中文乱码应统一设为 UTF-8 编码。
Git Graph 插件没反应？先确认它真在运行
装完插件却点不开图形界面，大概率是 Git 仓库没被正确识别。VSCode 不会自动把任意文件夹当 Git 项目——它只认 .git 目录存在且有效的根目录。
- 打开命令面板（
Ctrl+Shift+P或Cmd+Shift+P），输入Git: Show Git Output，看有没有报错如fatal: not a git repository - 确保你当前打开的是仓库根目录（不是子文件夹），或者右键资源管理器里的文件夹 →
Reopen Folder as Root - 插件启动依赖 VSCode 内置 Git 支持，检查设置里
git.path是否指向了正确的git可执行文件（比如/usr/bin/git或C:\Program Files\Git\bin\git.exe）
点开 Git Graph 后看不到分支？检查 reflog 和远程配置
默认视图只显示当前分支的提交和本地分支指针，远程分支、已删除但还在 reflog 里的分支、或孤立提交都可能“隐身”。
- 右上角点击
⋯→ 勾选Show Remote Branches才能看到origin/main这类 - 如果刚删过分支，它不会立刻消失：点
⋯→Refresh，再点⋯→Toggle Reflog，能找回最近 30 天内被删的分支头 - 某些企业 Git 服务器（如自建 GitLab）可能禁用了
ls-remote，导致远程分支加载失败；此时手动在终端跑git ls-remote --heads origin能验证连通性
右键菜单里 merge/rebase 按钮灰掉？权限和状态决定可操作性
Git Graph 的交互按钮是否可用，取决于当前选中提交的上下文，不是所有节点都能点。
- merge 按钮只对「当前分支所不在的、有共同祖先的分支顶端」生效；比如你在
feature/login上，右键main提交才亮，右键自己分支上的提交就灰 - rebase 按钮要求目标提交必须是当前分支的祖先（即不能往“未来” rebasing），且不能有未提交更改（
git status必须干净） - 如果提示
Unable to perform operation: Repository is in mid-rebase state，说明上次 rebase 卡住了，得先去终端跑git rebase --abort或--continue
提交信息乱码或中文显示为问号？编码不是 Git 的锅
Git 本身不处理编码，乱码根源在终端/编辑器环境变量和 VSCode 的文件关联设置。
- Windows 用户常见问题：Git Bash 默认用 GBK，但 VSCode 编辑器保存为 UTF-8，导致
git log --oneline显示正常，Git Graph 却乱码；解决方法是在 VSCode 设置里搜files.encoding，设为utf8，并确保系统环境变量LANG和LC_ALL没强制设成zh_CN.GBK - Mac/Linux 下如果用非 UTF-8 locale（比如
en_US.ISO8859-1），Git Graph 读取提交时会按 locale 解码，结果中文变 ；临时修复：终端进仓库后执行export LC_ALL=en_US.UTF-8，再重启 VSCode - Git Graph 不读取
.gitattributes里的encoding设置，所以别指望靠它解决
Git Graph 看起来直观，但它的状态感知完全依赖 VSCode 底层 Git API 的响应节奏——比如刚 push 完，要等几秒才能在图中看到远程分支箭头更新，这时候手快去点同步按钮反而可能触发冲突。稳住，等右下角 Git 图标停止旋转再说。
