Skip to content

QuincySnow/vscode-git-graph

Repository files navigation

Visual Studio Code 的 Git Graph 扩展

查看您仓库的 Git 图形,并轻松从图形中执行 Git 操作。可配置为您想要的外观!

Recording of Git Graph

功能特性

  • 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 + 向下),当遇到分支或合并时,将遵循替代分支。
      • 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 Marketplace 上获取,适用于 Visual Studio Code。

特别感谢原作者 mhutchie 创建了这个出色的 Git Graph 扩展!

感谢所有帮助 Git Graph 开发的贡献者!

Git 图形中使用的一些图标来自以下来源,请支持他们的出色工作!

About

View a Git Graph of your repository in Visual Studio Code, and easily perform Git actions from the graph.

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors