Git Graph插件可实现VSCode中Git提交历史的图形化可视化：安装后通过命令面板启动，支持自定义显示范围、执行检出/分支/合并等操作，并能导出SVG格式历史图。

如果您在VSCode中使用Git进行版本控制，但难以直观理解分支结构、提交关系与合并路径，则可能是由于命令行或内置Git视图缺乏图形化表达能力。以下是通过Git Graph插件实现Git提交历史可视化的具体操作方式：

本文运行环境：MacBook Air，macOS Sequoia。

一、安装Git Graph插件

Git Graph插件需先从VSCode扩展市场下载并启用，才能调用图形化界面功能。该插件不依赖外部Git GUI工具，所有渲染均在VSCode内部完成。

1、打开VSCode，点击左侧活动栏的扩展图标（四个方块组成的图标）。

2、在扩展搜索框中输入Git Graph，找到作者为mhutchie的官方插件。

3、点击“安装”按钮，等待状态变为“已启用”。

二、启动Git Graph视图

插件启用后，可通过命令面板或侧边栏快捷入口唤起Git Graph界面，该界面实时读取当前工作区的.git目录数据并生成有向无环图（DAG）。

1、按下Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux），打开命令面板。

2、输入并选择Git Graph: View Git Graph命令。

3、视图将以新标签页形式在编辑器主区域右侧展开，显示包含所有本地分支、提交节点与连接线的交互式图表。

三、自定义Git Graph显示范围

默认视图会加载全部分支及提交记录，当仓库历史较深时可能影响响应速度。可通过配置限制只显示指定分支或最近N次提交，提升加载效率与可读性。

1、点击Git Graph视图右上角的齿轮图标，打开设置菜单。

2、在“Branches to Include”中取消勾选不需要显示的远程分支，例如origin/gh-pages。

3、在“Max Commits to Load”中输入数值如200，限定仅加载最近200条提交。

四、在图中执行常用Git操作

Git Graph不仅展示历史，还支持直接在图形界面上完成检出、创建分支、合并、重置等操作，避免频繁切换终端或手动输入命令。

1、右键点击任意提交节点，在弹出菜单中选择Checkout Commit以进入分离头指针状态。

2、右键点击某分支名称，在菜单中选择Create Branch From This Commit，输入新分支名并确认。

3、按住Cmd（macOS）或多选两个提交节点后右键，选择Merge Selected Commits启动合并流程。

五、导出与分享Git历史图

为便于团队协作或文档归档，Git Graph支持将当前视图导出为SVG格式矢量图像，保留清晰缩放能力与原始颜色标识，无需截图或第三方工具。

1、点击Git Graph视图右上角的三个点菜单按钮（⋯）。

2、选择Export Graph as SVG选项。

3、在弹出的保存对话框中指定路径，文件将包含完整分支拓扑、提交哈希、作者与时间戳信息。

# linux  # this  # 图形化  # 加载  # 自定义  # 可通过  # 右键点击  # 运行环境  # 在弹出  # 不需要  # 菜单中  # 指针  # include  # cos  # vscode  # git  # svg  # windows  # macbook  # 工具  # mac  # ai  # macos  # win  # 右键