Better Git Line Blame 0.2.14

新的介绍内容：

Better Git Line Blame：VS Code的终极代码追踪工具

Better Git Line Blame是一个为Visual Studio Code设计的扩展程序，旨在通过显示当前行的git blame信息，帮助开发者更高效地追踪代码变更。它以其简洁和速度著称，是GitLens线条注释功能的轻量级替代方案。

安装方式：

您可以在Visual Studio Marketplace上获取Better Git Line Blame扩展，轻松提升您的开发体验。

主要功能：

• 以与GitLens相似的风格显示行注释。
• 可选地在状态栏显示blame信息。
• 缓存blame数据，确保注释即时显示。
• 悬停时显示提交作者、日期、消息和SHA。
• 自动链接到GitHub和GitLab的issues和PRs。
• 包含使用VS Code内置diff查看器的“显示差异”链接。
• 支持在同一工作区中的多个git仓库。
• 使用git blame --incremental提供快速且增量化的blame信息。
• 延迟加载提交消息，不阻塞blame注释的渲染。
• 处理未跟踪文件、未保存编辑和git分支变更。

命令集：

• Better Git Line Blame: 切换内联注释 - 切换用户设置文件中的betterGitLineBlame.showInlineAnnotations。
• Better Git Line Blame: 切换状态栏项目 - 切换用户设置文件中的betterGitLineBlame.showStatusBarItem。
• Better Git Line Blame: 显示提交 - 在单独的编辑器中显示提交消息，相当于点击状态栏项目。
• Better Git Line Blame: 显示提交（纯文本） - 与“显示提交”类似，但以纯文本而非Markdown形式呈现。
• Better Git Line Blame: 显示差异 - 显示当前文件的blame差异，相当于“显示差异”链接。
• Better Git Line Blame: 重新blame文件 - 对当前文件重新运行git blame。
• Better Git Line Blame: 清除缓存 - 清除所有缓存的git blame数据。

配置选项：

• betterGitLineBlame.showInlineAnnotations (默认: true) - 以内联注释的形式显示git blame信息。悬停在注释上查看更多详情。
• betterGitLineBlame.showStatusBarItem (默认: false) - 在状态栏中显示git blame信息。点击状态栏项目查看更多详情。
• betterGitLineBlame.enableHoverMessages (默认: true) - 悬停在内联注释上时显示提交详情。
• betterGitLineBlame.annotateWholeLine (默认: false) - 将注释附加到整行。这可以防止在删除行时出现闪烁，但在整行悬停时显示提交详情。
• betterGitLineBlame.statusBarItemPriority (默认: 500) - 状态栏项目的优先级。项目从高到低优先级排序，从左到右。
• betterGitLineBlame.ignoreWhitespaceChanges (默认: true) - 在blame行时忽略空白变化，即传递-w标志给git blame。
• betterGitLineBlame.reblameOnSave (默认: false) - 保存时自动运行“重新blame文件”命令。
• betterGitLineBlame.maxSummaryLength (默认: 50) - 行注释中提交消息摘要的最大长度。超过此长度的摘要将以省略号截断。设置为0表示无限制。
• workbench.colorCustomizations > betterGitLineBlame.foregroundColor - 内联blame注释的前景色。

常见问题解答：

需要重新blame吗？

仅当您在没有差异的行上看到“未提交的更改”时才需要重新blame。该扩展会跟踪本地编辑，并在git HEAD发生变化时重新blame，因此您通常不需要运行“重新blame文件”命令或使用betterGitLineBlame.reblameOnSave配置。然而，如果您更改了一行然后稍后撤销了它，注释仍然会显示“未提交的更改”。如果您想看到原始提交，您需要重新blame。

为什么删除或合并行时注释会闪烁？

默认情况下，扩展将注释附加到行尾。当您使用VS Code的“删除行”或“合并行”命令时，注释可能会暂时出现在行中间，将行其余部分向右移动，然后自行纠正。这种情况在使用远程开发时通常更为明显。

如果这让您感到困扰，您可以启用betterGitLineBlame.annotateWholeLine配置属性。这将使注释使用isWholeLine: true，确保它们永远不会出现在行中间。其缺点是，当您在整行上悬停时会显示提交信息，而不仅仅是当您悬停在blame注释上时。特别是，它会与其他扩展提供的悬停消息（如类型信息和文档）结合。

替代方案：

我竞争的替代品是GitLens。我发现它过于臃肿，并且不喜欢它推广付费功能。

另一个人也有同样的想法，carlthome/vscode-git-line-blame。然而，截至2024年3月，该扩展要简单得多：每次文本光标移动时都会启动一个git进程。

许可证：

© 2024 Mitchell Kember

VS Code Git Line Blame在MIT许可证下可用；详情请见LICENSE文件。