Git Graph 插件可将 Git 提交历史可视化，提升分支结构与合并关系的理解效率；需安装插件、通过快捷键或命令面板打开视图、筛选分支、点击节点查看详情，并支持右键执行创建分支、切换分支和重置等操作。
如果您在 VSCode 中使用 Git 进行版本控制，但难以直观理解分支结构、合并关系与提交时序，则 Git Graph 插件可将抽象的提交历史转化为清晰的图形化视图。以下是启用并高效使用该插件的操作流程：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装 Git Graph 插件
Git Graph 并非 VSCode 内置功能，需通过扩展市场手动安装，确保其核心图形渲染能力被正确载入工作区。
1、打开 VSCode，点击左侧活动栏最下方的扩展图标（四个方块组成的图标）。
2、在扩展搜索框中输入 Git Graph，确认作者为 mhutchie。
3、在搜索结果中找到对应条目，点击“安装”按钮，等待状态变为“已安装”。
4、安装完成后，点击“重新加载窗口”使插件生效。
二、打开 Git Graph 视图
插件安装后需主动调用视图面板，才能显示提交图谱；该视图独立于编辑器区域，支持拖拽调整尺寸与位置。
1、按下快捷键 Cmd+Shift+G（macOS）或 Ctrl+Shift+G（Windows/Linux）。
2、或通过顶部菜单栏依次选择：查看 → 命令面板 → 输入 “Git Graph: View Git Graph” 并回车。
3、视图首次加载时将自动读取当前工作区的 .git 目录，生成包含所有本地分支的交互式拓扑图。
三、筛选与聚焦特定分支
当仓库存在多个长期分支或大量 feature 分支时，全量图谱可能信息过载；通过分支筛选可快速定位目标上下文。
1、在 Git Graph 视图右上角点击 Filter 按钮（漏斗图标）。
2、勾选希望显示的分支名称，取消勾选无关分支，例如仅保留 main 与 develop。
3、点击 “Apply Filter”，视图立即刷新，仅呈现所选分支及其直接关联提交与合并点。
四、查看某次提交的详细信息
图形节点代表单次提交，点击任一节点可展开其元数据与变更摘要，辅助判断代码演进逻辑与影响范围。
1、在图中用鼠标左键单击任意圆形提交节点。
2、右侧详情面板将显示该提交的哈希值、作者、时间戳、提交信息正文及关联标签。
3、向下滚动可查看本次提交修改的文件列表，点击文件名可跳转至差异对比界面。
五、执行常用 Git 操作
Git Graph 不仅展示历史，还集成高频操作入口，避免频繁切换终端或命令行，提升操作连贯性。
1、右键点击某次提交节点，在弹出菜单中选择 Create New Branch，输入新分支名并确认。
2、右键点击某分支指针（如 main），选择 Checkout Branch 切换工作分支。
3、右键点击某次提交，选择 Reset Current Branch to Here，并在弹窗中选择软重置或硬重置模式。
