查看您仓库的 Git 图形,并轻松从图形中执行 Git 操作。可配置为您想要的外观!
- Git 图形视图:
- 显示:
- 本地和远程分支
- 本地引用:分支头、标签和远程引用
- 未提交的更改
- 执行 Git 操作(通过右键点击提交/分支/标签可用):
- 创建、检出、删除、获取、合并、拉取、推送、变基、重命名和重置分支
- 添加、删除和推送标签
- 检出、拣选、丢弃、合并和还原提交
- 清理、重置和暂存未提交的更改
- 应用、从暂存创建分支、丢弃和弹出暂存
- 查看注释标签详情(姓名、邮箱、日期和消息)
- 将提交哈希值以及分支、暂存和标签名称复制到剪贴板
- 通过点击提交查看提交详情和文件更改。在提交详情视图中您可以:
- 通过点击任何文件更改查看 Visual Studio Code 的差异视图。
- 打开提交中受影响文件的当前版本。
- 将提交中受影响文件的路径复制到剪贴板。
- 点击提交正文中的任何 HTTP/HTTPS URL 在默认网页浏览器中打开。
- 通过点击一个提交,然后 CTRL/CMD 点击另一个提交来比较任意两个提交。在提交比较视图中您可以:
- 通过点击查看所选提交之间任何文件更改的 Visual Studio Code 差异视图。
- 打开所选提交之间受影响文件的当前版本。
- 将所选提交之间受影响文件的路径复制到剪贴板。
- Code Review - 跟踪您在提交详情和比较视图中已审查的文件。
- 可以在任何提交或两个提交之间执行代码审查(不包括未提交的更改)。
- 启动代码审查时,需要审查的所有文件将以粗体显示。当您查看差异或打开文件时,它将不再以粗体显示。
- 代码审查在 Visual Studio Code 会话之间保持。它们在 90 天不活动后自动关闭。
- 查看未提交的更改,并将未提交的更改与任何提交进行比较。
- 悬停在图形上的任何提交顶点上,以查看工具提示,指示:
- 提交是否包含在 HEAD 中。
- 哪些分支、标签和暂存包含提交。
- 使用“分支”下拉菜单过滤图形中显示的分支。过滤分支的选项包括:
- 显示所有分支
- 选择一个或多个分支进行查看
- 选择用户预定义的自定义 glob 模式数组(通过设置
git-graph.customBranchGlobPatterns)
- 从远程获取(可在顶部控制栏中使用)
- 查找小部件允许您快速查找包含特定短语(在提交消息/日期/作者/哈希、分支或标签名称中)的一个或多个提交。
- 仓库设置小部件:
- 允许您查看、添加、编辑、删除、获取和修剪仓库的远程仓库。
- 配置“问题链接”- 将提交消息中的问题编号转换为链接,打开问题跟踪系统中的问题。
- 配置“拉取请求创建”- 自动打开和预填充拉取请求表单,直接从分支的上下文菜单中。
- 内置支持公开托管的 Bitbucket、GitHub 和 GitLab 拉取请求提供程序。
- 可以使用扩展设置
git-graph.customPullRequestProviders配置自定义拉取请求提供程序(例如,用于私有托管的拉取请求提供程序)。有关如何配置自定义提供程序的信息,请参见 此处。
- 导出您的 Git 图形仓库配置到文件中,可以提交到仓库中。它允许其他人在同一仓库中工作时自动使用相同的 Git 图形配置。
- 键盘快捷键(在 Git 图形视图中可用):
CTRL/CMD + F:打开查找小部件。CTRL/CMD + H:将 Git 图形视图滚动到以 HEAD 引用的提交为中心。CTRL/CMD + R:刷新 Git 图形视图。CTRL/CMD + S:将 Git 图形视图滚动到加载的提交中的第一个(或下一个)暂存。CTRL/CMD + SHIFT + S:将 Git 图形视图滚动到加载的提交中的最后一个(或上一个)暂存。- 当提交详情视图打开时:
向上/向下:提交详情视图将打开在 Git 图形视图中直接位于其上方或下方的提交。CTRL/CMD + 向上/CTRL/CMD + 向下:提交详情视图将打开其子提交或父提交(在同一分支上)。- 如果同时按下 Shift 键(即
CTRL/CMD + SHIFT + 向上/CTRL/CMD + SHIFT + 向下),当遇到分支或合并时,将遵循替代分支。
- 如果同时按下 Shift 键(即
Enter:如果打开了对话框,按 Enter 提交对话框,执行主要(左侧)操作。Escape:关闭活动对话框、上下文菜单或提交详情视图。
- 调整每列的宽度,并显示/隐藏日期、作者和提交列。
- 公共表情符号快捷码在提交消息中自动替换为相应的表情符号(包括所有 gitmoji)。可以在
git-graph.customEmojiShortcodeMappings中定义自定义表情符号快捷码映射。
- 显示:
- 一个广泛的可配置设置范围(例如图形样式、分支颜色等)。有关更多信息,请参见下面的“扩展设置”部分。
- 状态栏中的“Git 图形”启动按钮
- 命令面板中的“Git 图形:查看 Git 图形”启动命令
所有 Git 图形设置的详细信息可在此处获取,包括:描述、截图、默认值和类型。
Git 图形扩展设置的摘要如下:
- 提交详情视图:
- 自动居中:打开提交详情视图时自动居中。
- 文件视图:
- 文件树:
- 紧凑文件夹:以紧凑形式呈现提交详情视图中的文件树,使具有单个子文件夹的文件夹压缩为单个组合文件夹元素。
- 类型:设置提交详情视图中使用的默认文件视图类型。
- 文件树:
- 位置:指定提交详情视图在 Git 图形视图中的渲染位置。
- 上下文菜单操作可见性:自定义哪些上下文菜单操作可见。有关更多信息,请参见此处的文档。
- 自定义分支 Glob 模式:要在“分支”下拉菜单中显示的自定义 Glob 模式数组。示例:
[{"name":"功能请求","glob":"heads/feature/*"}] - 自定义表情符号快捷码映射:自定义表情符号快捷码映射数组。示例:
[{"shortcode": ":sparkles:", "emoji":"✨"}] - 自定义拉取请求提供程序:一个自定义拉取请求提供程序数组,可用于“拉取请求创建”集成。有关如何配置此设置的信息,请参见此处的文档。
- 日期:
- 格式:指定 Git 图形视图中“日期”列的日期格式。
- 类型:指定 Git 图形视图中“日期”列的日期类型,可以是作者日期或提交日期。
- 默认列可见性:一个对象,指定日期、作者和提交列的默认可见性。示例:
{"Date": true, "Author": true, "Commit": true} - 对话框 > *:设置以下对话框的默认选项:添加标签、应用暂存、拣选、创建分支、删除分支、获取到本地分支、获取远程、合并、弹出暂存、拉取分支、变基、重置和暂存未提交的更改。
- 增强的可访问性:为视觉文件更改 A|M|D|R|U 指示器在提交详情视图中提供颜色盲视用户的可访问性。在将来,此设置将启用任何其他可访问性相关功能,Git 图形默认情况下不启用。
- 文件编码:检索存储库文件的特定版本时使用的字符集编码(例如,在差异视图中)。支持的所有编码列表可在此处找到。
- 图形:
- 颜色:指定图形上使用的颜色。
- 样式:指定图形的样式。
- 未提交的更改:指定未提交的更改在图形上的显示方式。
- 集成终端 Shell:指定 Visual Studio Code 集成终端使用的 Shell 可执行文件的路径和文件名,当 Git 图形打开集成终端时。
- 键盘快捷键 > *:配置 Git 图形视图中所有键盘快捷键的键绑定。
- Markdown:在提交消息和标签详细信息中解析和呈现频繁使用的内联 Markdown 格式化规则的子集(粗体、斜体、粗体和斜体以及内联代码块)。
- 仓库搜索的最大深度:指定在工作区中发现存储库时要搜索的子文件夹的最大深度。
- 打开新标签编辑器组:指定 Git 图形应在哪个编辑器组中打开新标签,当从 Git 图形视图执行以下操作时:查看 Visual Studio Code 差异视图、打开文件、查看文件的特定修订版本。
- 打开到活动文本编辑器文档的仓库:打开 Git 图形视图到包含活动文本编辑器文档的仓库。
- 引用标签:
- 对齐:指定分支和标签引用标签在每个提交中的对齐方式。
- 合并本地和远程分支标签:如果本地和远程分支标签引用相同的分支,并且位于同一提交上,则合并本地和远程分支标签。
- 仓库:
- 提交:
- 获取头像:获取提交作者和提交者的头像。
- 初始加载:指定要初始加载的提交数。
- 加载更多:指定当单击“加载更多提交”按钮或自动加载更多提交时要加载的额外提交数。
- 自动加载更多:当视图滚动到底部时,如果存在更多提交,则自动加载更多提交(而不是单击“加载更多提交”按钮)。
- 静音:
- 不是 HEAD 的祖先的提交:使用静音文本颜色显示不是 HEAD 祖先的提交。
- 合并提交:使用静音文本颜色显示合并提交。
- 顺序:指定 Git 图形视图中提交的顺序。有关每个顺序选项的更多信息,请参见 git 日志。
- 显示签名状态:在提交详情视图中显示提交的签名状态(仅适用于已签名的提交)。将鼠标悬停在签名图标上时,会显示一个工具提示,显示签名详细信息。
- 获取和修剪:在使用 Git 图形视图控制栏上的“获取”按钮从远程获取之前,删除远程上不再存在的任何远程跟踪引用。
- 获取和修剪标签:在使用 Git 图形视图控制栏上的“获取”按钮从远程获取之前,删除远程上不再存在的任何本地标签。
- 包含 reflog 中提到的提交:包含仅由 reflog 提到的提交(仅在显示所有分支时适用)。
- 加载时:
- 滚动到头:自动滚动 Git 图形视图,使其以 HEAD 引用的提交为中心。
- 显示已签出的分支:加载仓库时在 Git 图形视图中显示已签出的分支。
- 显示特定分支:加载仓库时在 Git 图形视图中显示特定分支。
- 仅遵循第一个父级:仅遵循提交的第一个父级来发现要加载到 Git 图形视图中的提交。有关此设置的更多信息,请参见 --first-parent。
- 显示仅由标签引用的提交:在 Git 图形中显示仅由标签引用的提交。
- 显示远程分支:默认情况下在 Git 图形中显示远程分支。
- 显示远程头:默认情况下在 Git 图形中显示远程头符号引用。
- 显示暂存:默认情况下在 Git 图形中显示暂存。
- 显示标签:默认情况下在 Git 图形中显示标签。
- 显示未提交的更改:显示未提交的更改。如果您处理大型存储库,禁用此设置可以减少 Git 图形视图的加载时间。
- 显示未跟踪的文件:查看未提交的更改时显示未跟踪的文件。如果您处理大型存储库,禁用此设置可以减少 Git 图形视图的加载时间。
- 签名:
- 提交:启用使用 GPG 或 X.509 签名提交。
- 标签:启用使用 GPG 或 X.509 签名标签。
- 使用邮件映射:在显示作者和提交者姓名和电子邮件地址时尊重 .mailmap 文件。
- 提交:
- 仓库下拉菜单顺序:指定仓库下拉菜单中仓库的排序顺序(仅在当前 Visual Studio Code 工作区中存在多个仓库时可见)。
- 隐藏时保留上下文:指定当面板不再可见时(例如,移动到后台选项卡)是否保留 Git 图形视图的 Visual Studio Code 上下文。启用此设置将使 Git 图形在切换回 Git 图形选项卡时加载速度显著加快,但会占用更多内存。
- 显示状态栏项:显示一个状态栏项,当单击时打开 Git 图形视图。
- 源代码提供程序集成位置:指定“查看 Git 图形”操作在 SCM 提供程序标题中显示的位置。
- 标签图标颜色主题:指定 Git 图形标签中显示的图标的颜色主题。
此扩展使用以下设置:
git.path:指定便携式 Git 安装的路径和文件名。
此扩展提供以下命令:
git-graph.view:Git 图形:查看 Git 图形git-graph.addGitRepository:Git 图形:添加 Git 仓库...(用于向 Git 图形添加子仓库)git-graph.clearAvatarCache:Git 图形:清除头像缓存git-graph.endAllWorkspaceCodeReviews:Git 图形:结束工作区中的所有代码审查git-graph.endSpecificWorkspaceCodeReview:Git 图形:结束工作区中的特定代码审查...(用于结束特定代码审查而无需先在 Git 图形视图中打开)git-graph.fetch:Git 图形:从远程获取...(用于打开 Git 图形视图并立即运行“从远程获取”)git-graph.removeGitRepository:Git 图形:移除 Git 仓库...(用于从 Git 图形中移除仓库)git-graph.resumeWorkspaceCodeReview:Git 图形:恢复工作区中的特定代码审查...(用于打开 Git 图形视图到已进行的代码审查)git-graph.version:Git 图形:获取版本信息
详细的发布说明可在此处获取。
此扩展可在 Visual Studio Marketplace 上获取,适用于 Visual Studio Code。
特别感谢原作者 mhutchie 创建了这个出色的 Git Graph 扩展!
感谢所有帮助 Git Graph 开发的贡献者!
Git 图形中使用的一些图标来自以下来源,请支持他们的出色工作!
- GitHub Octicons (许可证)
- Icons8 (许可证)
