Skip to content

Latest commit

 

History

History
174 lines (155 loc) · 15.5 KB

File metadata and controls

174 lines (155 loc) · 15.5 KB

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 图形中使用的一些图标来自以下来源,请支持他们的出色工作!