Skip to content

About

Supercharge the Git capabilities built into Visual Studio Code — Visualize code authorship at a glance via Git blame annotations and code lens, seamlessly navigate and explore Git repositories, gain valuable insights via powerful comparison commands, and so much more

gitlens.amod.io

Resources

Readme
License

Code of conduct

Code of conduct

Contributing

Contributing
Activity

Stars

1 star

Watchers

0 watching

Forks

1 fork
Report repository
BranchesTags
 
 

Latest commit

 

History

3,879 Commits

Folders and files

NameName
Last commit message
Last commit date
.github
.github
 
 
.vscode
.vscode
 
 
images
images
 
 
patches
patches
 
 
scripts
scripts
 
 
src
src
 
 
walkthroughs
walkthroughs
 
 
.eslintrc.base.json
.eslintrc.base.json
 
 
.eslintrc.browser.json
.eslintrc.browser.json
 
 
.eslintrc.json
.eslintrc.json
 
 
.gitattributes
.gitattributes
 
 
.gitignore
.gitignore
 
 
.gitignore-revs
.gitignore-revs
 
 
.mailmap
.mailmap
 
 
.prettierignore
.prettierignore
 
 
.prettierrc
.prettierrc
 
 
.vscodeignore
.vscodeignore
 
 
.yarnrc
.yarnrc
 
 
BACKERS.md
BACKERS.md
 
 
CHANGELOG.md
CHANGELOG.md
 
 
CODE_OF_CONDUCT.md
CODE_OF_CONDUCT.md
 
 
CONTRIBUTING.md
CONTRIBUTING.md
 
 
LICENSE
LICENSE
 
 
LICENSE.plus
LICENSE.plus
 
 
README.en.md
README.en.md
 
 
README.insiders.md
README.insiders.md
 
 
README.md
README.md
 
 
ThirdPartyNotices.txt
ThirdPartyNotices.txt
 
 
USAGE.zh-CN.md
USAGE.zh-CN.md
 
 
esbuild.js
esbuild.js
 
 
icons.fig
icons.fig
 
 
package-lock.json
package-lock.json
 
 
package.json
package.json
 
 
package.nls.json
package.nls.json
 
 
package.nls.zh-cn.json
package.nls.zh-cn.json
 
 
tsconfig.base.json
tsconfig.base.json
 
 
tsconfig.browser.json
tsconfig.browser.json
 
 
tsconfig.json
tsconfig.json
 
 
tsconfig.test.json
tsconfig.test.json
 
 
webpack.config.images.js
webpack.config.images.js
 
 
webpack.config.js
webpack.config.js
 
 
webpack.config.test.js
webpack.config.test.js
 
 

Repository files navigation

English | 简体中文

本仓库为个人精简版 GitLens（publisher: piter）。
安装与用法见 USAGE.zh-CN.md。
特点：完整中文界面与命令、无账号/试用弹窗、大仓库延迟加载提交文件详情。


GitLens Logo

GitLens 增强了 VS Code 内部的 Git 功能。它通过行追溯和 CodeLens 帮助您一眼看清代码作者，浏览和探索 Git 仓库，通过可视化与比较命令获得洞察，等等。


打开 GitLens 12 新特性

打开 GitLens 12 新特性
或者阅读 发布说明

GitLens

GitLens 是 Visual Studio Code 的一款开源扩展。

GitLens 简单地帮助您更好地理解代码。快速查看一行或一个代码块是谁在什么时候因为什么原因更改的。回顾历史以获得进一步的洞察，了解代码是如何以及为什么要演进的。毫不费力地探索代码库的历史和演变。

GitLens 功能强大、特性丰富且高度可定制，以满足您的需求。您是否觉得 CodeLens 太碍眼，或者觉得当前行 blame 注释分散注意力 — 没问题，通过交互式的_GitLens 设置_编辑器快速关闭它们或更改它们的行为。对于高级自定义，请参阅 GitLens 文档并编辑您的用户设置。

以下是 GitLens 提供的一些特性：

GitLens+ 介绍 #

GitLens+ 添加了全新的、完全可选的特性，当您使用免费帐户登录时，这些特性会增强您当前的 GitLens 体验。免费的 GitLens+ 帐户允许您在公共仓库上访问这些新的 GitLens+ 特性，而付费帐户则允许您在私有仓库上使用它们。了解更多关于 GitLens+ 特性的信息。

🛈 所有其他 GitLens 特性始终无需帐户即可访问，并将继续演进和投入。

这会影响现有特性吗？

不会，GitLens+ 的引入对现有的 GitLens 特性没有影响，因此您不会失去对您熟悉和喜爱的任何 GitLens 特性的访问权限。事实上，我们正在大力投入通过增强和扩展 GitLens 特性集。创建一个帐户只是让您能够访问这些新特性子集，这将使您能够更好地在 VS Code 中利用 Git！

可视化文件历史试图 #

可视化文件历史视图

可视化文件历史视图允许您快速查看文件的演变过程，包括何时进行了更改、更改幅度有多大以及是谁进行的更改。

为文件贡献过更改的作者位于左侧 Y 轴上，以创建随时间变化（X 轴）的提交泳道。提交被绘制为按作者着色的气泡，其大小代表更改的相对规模。

此外，每个提交的添加和删除都被可视化为颜色编码的堆叠垂直条，其高度代表受影响的行数（右侧 Y 轴）。增加的行显示为绿色，而删除的行显示为红色。

工作区 (Worktrees) 视图 #

工作区视图

工作区允许您轻松地同时在仓库的不同分支上工作。您可以创建多个工作区，每个工作区都可以在单独的窗口中打开，也可以在单个工作区中放在一起。

特性

版本导航 #

版本导航

  • 添加 与上一版本打开更改 命令 (gitlens.diffWithPrevious)，将当前文件或版本与上一个提交版本进行比较
  • 添加 与下一版本打开更改 命令 (gitlens.diffWithNext)，将当前文件或版本与下一个提交版本进行比较
  • 添加 与上一行版本打开更改 命令 (gitlens.diffLineWithPrevious)，将当前文件或版本与上一行提交版本进行比较
  • 添加 与工作区文件打开更改 命令 (gitlens.diffWithWorking)，将当前版本的或当前文件最近的提交版本与工作区进行比较
  • 添加 与工作区文件打开行更改 命令 (gitlens.diffLineWithWorking)，将当前行的提交版本与工作区进行比较
  • 添加 与分支或标签打开更改... 命令 (gitlens.diffWithRevisionFrom)，将当前文件或版本与所选引用的同一文件的另一个版本进行比较
  • 添加 与版本打开更改... 命令 (gitlens.diffWithRevision)，将当前文件或版本与同一文件的另一个版本进行比较

当前行 Blame #

当前行 Blame

  • 在当前行末尾添加一个不显眼的、可自定义且支持主题样式的 Blame 注释
    • 包含当前行最近提交的作者、日期和消息（默认）
    • 添加 切换行 Blame 命令 (gitlens.toggleLineBlame)，用于切换 blame 注释的开启和关闭

Git CodeLens #

Git CodeLens

  • 在文件顶部和代码块上添加 Git 作者身份 CodeLens（可选，默认开启）

    • 最近的更改 — 文件或代码块最近一次提交的作者和日期

      • 点击 CodeLens 显示提交文件详细信息快速挑选菜单，其中包含用于比较、导航、探索提交等命令（默认）

    • 作者数量 — 文件或代码块的作者数量和最主要的作者（如果超过一个）

      • 点击 CodeLens 切换整个文件的 Git blame 注释的开启和关闭（默认）
      • 如果最近一个提交的作者也是该文件或块的唯一作者，则会被隐藏，以避免重复信息并减少视觉干扰

    • 为每个 CodeLens 提供可自定义的点击行为 — 从以下选项中选择一个：

      • 切换文件 blame 注释开启和关闭
      • 将该提交与前一个提交进行比较
      • 显示包含该提交详细信息和命令的快速挑选菜单
      • 显示包含该提交的文件详细信息和命令的快速挑选菜单
      • 显示该文件的提交历史快速挑选菜单
      • 显示当前分支的提交历史快速挑选菜单

  • 添加 切换 Git CodeLens 命令 (gitlens.toggleCodeLens)，快捷键为 Shift+Alt+B，用于切换 CodeLens 的开启和关闭

状态栏 Blame #

状态栏 Blame

  • 在状态栏中添加一个可自定义的 Git blame 注释，显示最后修改当前行的提交和作者（可选，默认开启）

    • 包含提交作者和日期（默认）

    • 点击状态栏项显示提交详细信息快速挑选菜单，其中包含用于比较、导航、探索提交等命令（默认）

    • 提供可自定义的点击行为 — 从以下选项中选择一个：

      • 切换文件 blame 注释开启和关闭
      • 切换 CodeLens 开启和关闭
      • 将行提交与前一提交进行比较
      • 将行提交与工作区进行比较
      • 显示包含提交详细信息和命令的快速挑选菜单（默认）
      • 显示包含提交文件详细信息和命令的快速挑选菜单
      • 显示该文件的提交历史快速挑选菜单
      • 显示当前分支的提交历史快速挑选菜单

悬停 (Hovers) #

当前行悬停

当前行悬停

  • 添加可自定义的 Git blame 悬停，可在当前行上方访问

详细信息悬停

当前行详细信息悬停

  • 为当前行添加详细信息悬停注释，以显示更多提交详情（可选，默认开启）
    • 在提交消息中提供指向 Bitbucket, Gerrit, Gitea, GitHub, GitLab 和 Azure DevOps 的自动问题链接
    • 提供快速访问命令栏，包含 打开更改、追溯上一修订版本、在远程打开、邀请参加 Live Share（如果可用）和 显示更多操作 命令按钮
    • 点击提交 SHA 执行 显示提交 命令

更改 (diff) 悬停

当前行更改 (diff) 悬停

  • 为当前行添加更改 (diff) 悬停注释，以显示该行的上一个版本（可选，默认开启）
    • 点击 更改 执行 打开更改 命令
    • 点击当前和以前的提交 SHA 执行 显示提交 命令

注释悬停

注释悬停

  • 添加可自定义的 Git blame 悬停，在查看注释时可用

详细信息悬停

注释详细信息悬停

  • 在查看注释时，为每一行添加详细信息悬停注释，以显示更多提交详情（可选，默认开启）
    • 在提交消息中提供指向 Bitbucket, Gerrit, Gitea, GitHub, GitLab 和 Azure DevOps 的自动问题链接
    • 提供快速访问命令栏，包含 打开更改、追溯上一修订版本、在远程打开、邀请参加 Live Share（如果可用）和 显示更多操作 命令按钮
    • 点击提交 SHA 执行 显示提交 命令

更改 (diff) 悬停

注释更改 (diff) 悬停

  • 在查看注释时，为每一行添加更改 (diff) 悬停注释，以显示该行的上一个版本（可选，默认开启）
    • 点击 更改 执行 打开更改 命令
    • 点击当前和以前的提交 SHA 执行 显示提交 命令

侧栏 (Gutter) Blame #

侧栏 Blame

  • 添加按需显示、可自定义且支持主题样式的 侧栏 blame 注释，显示文件中每一行最后修改的提交和作者
    • 默认包含提交消息和日期（默认）
    • 在侧栏右侧边缘添加热度图（时长）指示器（默认），提供一种简单直观的方法来判断行更改的最近程度（可选，默认开启）
    • 添加 切换文件 Blame 命令 (gitlens.toggleFileBlame)，快捷键为 Alt+B，用于切换 blame 注释的开启和关闭
    • 按 Esc 键关闭注释

侧栏更改 (Gutter Changes) #

侧栏更改

  • 添加按需显示、可自定义且支持主题样式的 侧栏更改注释，高亮显示任何本地（未发布）的更改或由最近提交更改的行
    • 添加 切换文件更改 命令 (gitlens.toggleFileChanges)，用于切换更改注释的开启和关闭
    • 按 Esc 键关闭注释

侧栏热度图 (Gutter Heatmap) #

侧栏热度图

  • 在侧栏边缘添加按需显示的热度图，以显示行更改的最近程度
    • 指示器的可自定义颜色将根据最近更改的时间长短显示为热或冷（默认 90 天后为冷）
    • 指示器的亮度根据相对时长从亮（较新）到暗（较旧）不等，相对时长是根据文件中所有更改的中值时长计算的
    • 添加 切换文件热度图注释 命令 (gitlens.toggleFileHeatmap)，用于切换热度图的开启和关闭
    • 按 Esc 键关闭注释

侧边栏视图 (Side Bar Views) #

GitLens 提供了一系列强大的侧边栏视图，帮助您可视化、导航和探索 Git 仓库。

在 VS Code 侧边栏中通过 GitLens 图标或通过 GitLens: 显示侧边栏 命令访问这些视图。

侧边栏视图

“提交 (Commits)”视图 #

“提交”视图

  • 可视化、探索和管理 Git 提交
  • 显示当前分支或选定引用的提交历史
  • 查看提交的详细信息、更改的文件和差异

“仓库 (Repositories)”视图 #

“仓库”视图

  • 可视化、探索和管理 Git 仓库
  • 显示仓库的分支、远程、标签和暂存
  • 快速切换分支、拉取/推送更改以及管理仓库设置

“文件历史 (File History)”视图 #

“文件历史”视图

  • 可视化、导航和探索当前文件或当前文件所选行的修订历史
  • 在不同版本之间快速切换
  • 比较文件在不同提交中的差异

“行历史 (Line History)”视图 #

“行历史”视图

  • 可视化、导航和探索当前文件所选行的修订历史
  • 专注于代码特定部分的演变

“分支 (Branches)”视图 #

“分支”视图

  • 可视化、探索和管理 Git 分支
  • 轻松创建、重命名、删除和切换分支
  • 比较分支与当前分支或工作区的差异

“远程 (Remotes)”视图 #

“远程”视图

  • 可视化、探索和管理 Git 远程仓库和远程分支
  • 获取 (Fetch) 更改并可视化远程分支的状态

“暂存 (Stashes)”视图 #

“暂存”视图

  • 可视化、探索和管理 Git 暂存
  • 轻松查看暂存的内容、应用暂存或删除暂存

“标签 (Tags)”视图 #

“标签”视图

  • 可视化、探索和管理 Git 标签
  • 快速导航到带标签的版本

“贡献者 (Contributors)”视图 #

“贡献者”视图

  • 可视化、导航和探索贡献者
  • 查看每个贡献者的提交活动和统计统计信息

“搜索与比较 (Search & Compare)”视图 #

“搜索与比较”视图

  • 按消息、作者、文件、ID 等搜索和探索提交历史
  • 可视化分支、标签、提交等之间的比较

Git 命令面板 #

Git 命令面板

  • 添加 Git 命令面板命令 (gitlens.gitCommands)，快捷键为 Ctrl+Alt+G（macOS 上为 Meta+Alt+G）
    • 提供许多常用 Git 命令的引导式（逐步）访问
    • 减少了记住命令或标志的需求
    • 允许在执行命令之前预览其效果

快速访问提交 #

  • 添加 Git: 搜索提交... (gitlens.showCommitSearch) 和 Git: 文件历史... (gitlens.showQuickFileHistory) 命令
    • 允许您通过消息、作者、提交 SHA、文件或包含特定更改的文件来搜索和发现提交
    • 可视化搜索结果并进一步探索和管理它们

快速访问暂存 #

  • 添加 Git: 暂存... (gitlens.showQuickStashList) 命令
    • 允许您可视化、探索和管理您的暂存

快速访问状态 #

  • 添加 Git: 状态... (gitlens.showQuickRepoStatus) 命令
    • 允许您可视化、探索和管理当前分支和工作区的状态

交互式变基 (Rebase) 编辑器 #

交互式变基编辑器

  • 添加用户友好的 交互式变基编辑器
    • 在启动交互式变基时自动显示
    • 允许您直观地重新排列、挑选 (pick)、丢弃 (drop)、合并 (squash) 和重命名 (reword) 提交
    • 提供冲突警告和其他有用的提示来指导您完成变基过程

终端链接 #

终端链接

  • 在集成终端中自动检测并链接提交 SHA、分支、标签等
  • Ctrl+点击 (macOS 上为 Cmd+点击) 链接可快速显示相关实体的详细信息和命令

远程托管商集成 #

  • 强大的远程托管商集成 (GitHub, GitLab, Gitea, Gerrit, Bitbucket, Azure DevOps)
  • 允许您直接在 VS Code 中浏览仓库、打开拉取请求、查看问题等
  • 集成了自动链接、悬停详细信息和拉取请求关联等特性（各平台的详细程度可能有所不同）

强大的命令 #

GitLens 提供了许多强大的命令，通过命令面板或右键菜单访问。一些关键命令包括：

  • 在远程查看... — 在 Web 浏览器中打开当前文件、行或提交的远程链接
  • 复制远程链接... — 将当前文件、行或提交的远程链接复制到剪贴板
  • 显示文件记录中的物理行... — 探索文件的演变
  • 按 ID 或引用显示提交... — 快速查找特定提交
  • 以及更多...

菜单和工具栏 #

  • 提供可自定义的设置，以控制 GitLens 命令在 VS Code 菜单和工具栏中的显示位置

模式 (Modes) #

  • 允许您定义自定义模式，这些模式可以快速切换一组 GitLens 设置
  • 例如，可以有一个“极简”模式通过一个命令关闭所有不必要的 UI 元素

GitLens 设置 #

GitLens 提供了广泛的设置，允许您根据自己的喜好定制其行为。许多这些设置可以通过集成的 GitLens 设置 编辑器以交互方式进行配置。

配置 #

要配置 GitLens，请运行 GitLens: 打开设置 命令。

GitLens 设置

此外，您还可以通过用户设置文件配置 GitLens。

常规设置 #

名称 描述
gitlens.insiders 指定是否订阅 GitLens 的开发者内部预览版 (Insiders)
gitlens.showLabels 指定是否在视图和菜单中显示标签
gitlens.statusBar.enabled 指定是否启用 GitLens 状态栏项
gitlens.views.repositories.location 指定 仓库 视图在侧边栏中的位置

当前行 Blame 设置 #

名称 描述
gitlens.currentLine.enabled 指定是否在当前行末尾显示 blame 注释
gitlens.currentLine.fontFamily 指定当前行 blame 注释的字体系列（如果未指定，则使用编辑器的字体系列）
gitlens.currentLine.format 指定当前行 blame 注释的格式。参见 GitLens 文档中的 提交令牌 (Commit Tokens)。日期格式由 gitlens.currentLine.dateFormat 设置控制
gitlens.currentLine.dateFormat 指定如何格式化绝对日期（例如使用 ${date} 令牌）。有关支持的格式，请参阅 Moment.js 文档
gitlens.currentLine.scrollable 指定当前行 blame 注释是否可随当前行滚动

Git CodeLens 设置 #

名称 描述
gitlens.codeLens.enabled 指定是否在编辑器中显示 Git 代码透镜 (CodeLens)
gitlens.codeLens.recentChange.enabled 指定是否显示最近更改的代码透镜
gitlens.codeLens.recentChange.command 指定点击最近更改代码透镜时要运行的命令

null — 不运行任何命令
gitlens.showQuickCommitDetails — 显示当前提交详情
gitlens.diffWithPrevious — 比较当前提交与上一个版本
以及更多...
gitlens.codeLens.authors.enabled 指定是否显示作者数量的代码透镜
gitlens.codeLens.authors.command 指定点击作者数量代码透镜时要运行的命令

null — 不运行任何命令
gitlens.toggleFileBlame — 切换文件 blame 注释
以及更多...
gitlens.codeLens.scopes 指定在哪些作用域下显示 Git 代码透镜

document — 仅在文件顶部显示
containers — 在类、模块等上显示
blocks — 在块（函数、方法等）上显示

状态栏 Blame 设置 #

名称 描述
gitlens.statusBar.enabled 指定是否在状态栏中显示 blame 注释
gitlens.statusBar.alignment 指定状态栏 blame 注释的对齐方式

left — 左对齐
right — 右对齐
gitlens.statusBar.command 指定点击状态栏 blame 注释时要运行的命令

null — 不运行任何命令
gitlens.showQuickCommitDetails — 显示当前提交详情（默认）
gitlens.toggleFileBlame — 切换文件 blame 注释
以及更多...
gitlens.statusBar.format 指定状态栏 blame 注释的格式。参见 GitLens 文档中的 提交令牌 (Commit Tokens)。日期格式由 gitlens.statusBar.dateFormat 设置控制
gitlens.statusBar.dateFormat 指定如何格式化绝对日期（例如使用 ${date} 令牌）。有关支持的格式，请参阅 Moment.js 文档

悬停设置 #

名称 描述
gitlens.hovers.enabled 指定是否在悬停中显示 blame 和差异信息
gitlens.hovers.annotations.enabled 指定在查看 blame 或热度图注释时是否显示详情悬停
gitlens.hovers.annotations.changes 指定在查看注释时是否在悬停中显示更改 (diff) 指示器
gitlens.hovers.currentLine.enabled 指定在当前行悬停中是否显示详情信息
gitlens.hovers.currentLine.changes 指定在当前行悬停中是否显示更改 (diff) 指示器
gitlens.hovers.avatars 指定是否在悬停中显示作者头像
gitlens.hovers.pullRequests.enabled 指定是否在悬停中显示关联的拉取请求信息。需要连接到支持的远程服务（如 GitHub）

视图设置 #

名称 描述
gitlens.views.avatars 指定是否在视图中显示作者头像
gitlens.views.formats.commits.label 指定提交在视图中的标签格式
gitlens.views.formats.commits.description 指定提交在视图中的描述格式
gitlens.views.formats.files.label 指定文件在视图中的标签格式
gitlens.views.formats.files.description 指定文件在视图中的描述格式

仓库视图设置 #

参见 视图设置

名称 描述
gitlens.views.repositories.avatars 指定是否在 仓库 视图中显示头像图像，而不是提交（或状态）图标
gitlens.views.repositories.autoRefresh 指定当仓库或文件系统发生更改时，是否自动刷新 仓库 视图
gitlens.views.repositories.autoReveal 指定在打开文件时是否自动在 仓库 视图中展开并选中该仓库
gitlens.views.repositories.branches.layout 指定 仓库 视图如何显示分支

list — 将分支显示为列表
tree — 当分支名称包含斜杠 / 时，将分支显示为树
gitlens.views.repositories.compact 指定是否在 仓库 视图中以紧凑密度显示
gitlens.views.repositories.files.layout 指定 仓库 视图如何显示文件

auto — 根据文件数量自动在 tree 或 list 之间切换
list — 将文件显示为列表
tree — 将文件显示为树
gitlens.views.repositories.showBranches 指定是否在 仓库 视图中显示每个仓库的分支
gitlens.views.repositories.showCommits 指定是否在 仓库 视图中显示每个仓库当前分支的提交
gitlens.views.repositories.showRemotes 指定是否在 仓库 视图中显示每个仓库的远程仓库
gitlens.views.repositories.showStashes 指定是否在 仓库 视图中显示每个仓库的暂存
gitlens.views.repositories.showTags 指定是否在 仓库 视图中显示每个仓库的标签

分支视图设置 #

参见 视图设置

名称 描述
gitlens.views.branches.avatars 指定是否在 分支 视图中显示头像图像，而不是提交（或状态）图标
gitlens.views.branches.branches.layout 指定 分支 视图如何显示分支

list — 将分支显示为列表
tree — 将分支显示为树
gitlens.views.branches.reveal 指定是否在 分支 视图中显示分支，否则它们将在 仓库 视图中显示

侧栏 Blame 设置 #

名称 描述
gitlens.blame.avatars 指定是否在侧栏 blame 注释中显示头像图像
gitlens.blame.compact 指定是否合并（去重）匹配的相邻侧栏 blame 注释
gitlens.blame.dateFormat 指定如何格式化绝对日期（例如使用 ${date} 令牌）。有关支持的格式，请参阅 Moment.js 文档
gitlens.blame.format 指定侧栏 blame 注释的格式。参见 GitLens 文档中的 提交令牌 (Commit Tokens)。日期格式由 gitlens.blame.dateFormat 设置控制
gitlens.blame.heatmap.enabled 指定是否在侧栏 blame 注释中提供热度图指示器
gitlens.blame.toggleMode 指定侧栏 blame 注释的切换方式

file — 单独切换每个文件
window — 切换整个窗口，即一次切换所有文件

侧栏更改设置 #

名称 描述
gitlens.changes.locations 指定侧栏更改注释的指示器显示位置

gutter — 添加侧栏指示器
overview — 在概览标尺（滚动条）中添加装饰
gitlens.changes.toggleMode 指定侧栏更改注释的切换方式

file — 单独切换每个文件
window — 切换整个窗口，即一次切换所有文件

侧栏热度图设置 #

名称 描述
gitlens.heatmap.ageThreshold 指定最新更改的年龄（天数），超过该期限后侧栏热度图注释将显示为冷色而非热色
gitlens.heatmap.locations 指定侧栏热度图注释的指示器显示位置

gutter — 添加侧栏指示器
overview — 在概览标尺（滚动条）中添加装饰
gitlens.heatmap.toggleMode 指定侧栏热度图注释的切换方式

file — 单独切换每个文件
window — 切换整个窗口，即一次切换所有文件

Git 命令面板设置 #

名称 描述
gitlens.gitCommands.closeOnFocusOut 指定在失去焦点时是否关闭 Git 命令面板 （如果不是，请按 ESC 关闭）
gitlens.gitCommands.sortBy 指定 Git 命令在 Git 命令面板 中的排序方式

name — 按名称排序
usage — 按最后使用日期排序

终端链接设置 #

名称 描述
gitlens.terminalLinks.enabled 指定是否启用终端链接 — 在集成终端中自动生成链接，以快速跳转到提交、分支、标签等的详细信息

远程托管商集成设置 #

名称 描述
gitlens.integrations.enabled 指定是否启用与任何支持的远程服务的丰富集成
gitlens.remotes 指定自定义远程服务，以便与 Git 远程匹配，自动检测自定义域名或为自定义远程服务提供支持

日期和时间设置 #

名称 描述
gitlens.defaultDateFormat 指定默认情况下绝对日期的格式格式。有关支持的格式，请参阅 Moment.js 文档
gitlens.defaultDateLocale 指定用于日期格式化的语言环境（BCP 47 语言标签），默认为 VS Code 语言环境。使用 system 随系统语言环境，或选择特定语言环境，如 zh-CN — 简体中文。
gitlens.defaultDateSource 指定提交日期应使用作者日期还是提交日期
gitlens.defaultDateStyle 指定默认情况下日期的显示样式

键盘快捷键设置 #

名称 描述
gitlens.keymap 指定用于 GitLens 快捷键的键映射

alternate — 添加一组以 Alt（macOS 上为 ⌥）开头的替代快捷键
chorded — 添加一组以 Ctrl+Shift+G（macOS 上为 ⇧⌘G）开头的和弦快捷键
none — 禁用快捷键

模式设置 #

名称 描述
gitlens.mode.active 指定当前的活动 GitLens 模式（如果有）
gitlens.modes 指定用户定义的 GitLens 模式

自动链接设置 #

名称 描述
gitlens.autolinks 指定提交消息中指向外部资源的自动链接。使用 <num> 作为引用编号的变量。例如："gitlens.autolinks": [{ "prefix": "JIRA-", "url": "https://jira.company.com/issue?query=<num>" }]

杂项设置 #

名称 描述
gitlens.defaultGravatarsStyle 指定 Gravatar 默认（备选）图像的样式
gitlens.outputLevel 指定发送到 GitLens 输出通道的信息级别
gitlens.showWelcomeOnInstall 指定是否在首次安装时显示欢迎（快速设置）体验
gitlens.showWhatsNewAfterUpgrades 指定是否在升级到新功能发布版本后显示“新特性”通知
gitlens.sortBranchesBy 指定快速挑选菜单和视图中分支的排序方式
gitlens.sortContributorsBy 指定快速挑选菜单和视图中贡献者的排序方式
gitlens.sortTagsBy 指定快速挑选菜单和视图中标签的排序方式
gitlens.advanced.abbreviatedShaLength 指定缩写的提交 SHA (shas) 的长度
gitlens.advanced.quickPick.closeOnFocusOut 指定在失去焦点时是否关闭快速挑选菜单
gitlens.advanced.repositorySearchDepth 指定搜索仓库的文件夹深度

支持主题的颜色 #

GitLens 定义了一组支持主题的颜色，可以由 VS Code 主题提供，或者由用户使用 workbench.colorCustomizations 直接提供。

名称 描述
gitlens.gutterBackgroundColor 指定侧栏 blame 注释的背景颜色
gitlens.gutterForegroundColor 指定侧栏 blame 注释的前景颜色
gitlens.gutterUncommittedForegroundColor 指定侧栏 blame 注释中未提交行的前景颜色
gitlens.trailingLineBackgroundColor 指定行末 blame 注释的背景颜色
gitlens.trailingLineForegroundColor 指定行末 blame 注释的前景颜色
gitlens.lineHighlightBackgroundColor 指定 blame 注释中关联行高亮的背景颜色
gitlens.lineHighlightOverviewRulerColor 指定 blame 注释中关联行高亮的概览标尺颜色

贡献者 🙏❤

衷心感谢为这个项目做出贡献的人们：

另外特别感谢提供支持、测试、头脑风暴等帮助的人们：

当然还有优秀的 vscode 团队！

许可证 (License)

此仓库包含 OSS 许可和非 OSS 许可的文件。

任何名为 "plus" 的目录中或其下的所有文件均受 LICENSE.plus 保护。

其余文件遵循 MIT 许可证。

About

Supercharge the Git capabilities built into Visual Studio Code — Visualize code authorship at a glance via Git blame annotations and code lens, seamlessly navigate and explore Git repositories, gain valuable insights via powerful comparison commands, and so much more

gitlens.amod.io

Resources

Readme
License

Code of conduct

Code of conduct

Contributing

Contributing
Activity

Stars

1 star

Watchers

0 watching

Forks

1 fork
Report repository

Releases

Packages

Contributors

Languages