GitLens 教学（学习更新中）

GitLens 是什么？

GitLens 是安装在 Visual Studio Code (VS Code) 中的一个功能极其强大的扩展程序，它直接内嵌在您的代码编辑器中，极大地增强了 VS Code 内置的 Git 功能。它的核心目标是：

1. 深刻理解代码历史： 让您轻松查看“谁”、“何时”以及“为什么”修改了代码。
2. 提升开发效率： 提供可视化工具（如 Commit Graph）、快速导航和工作流程管理（如 Worktrees），减少上下文切换。
3. 优化团队协作： 简化代码审查（PR 处理）、分享（Cloud Patches）和讨论（Code Suggest）的流程。
4. 内联信息集成： 在您的代码行旁边、文件顶部等位置直接展示丰富的 Git 信息，无需离开编辑器。

核心版本：

• GitLens Community (社区版 - 免费): 提供了极其强大的核心功能，如内联 blame、文件历史导航、丰富的悬停信息、CodeLens 等，非常适合个人开发者了解代码历史和基础 Git 操作。
• GitLens Pro (专业版 - 需订阅): 解锁了更高级的工作流功能，主要面向团队协作和生产效率提升，例如：
  • Home View (工作首页)： 工作流程管理中枢。
  • Launchpad (任务板)： 集中管理 PR 和任务。
  • Pro Commit Graph (加强版提交图谱)： 强大的搜索、过滤和可视化操作。
  • Worktrees (工作树)： 同时处理多个分支。
  • Visual File History (可视化文件历史)： 图形化展示文件变更。
  • GitKraken AI (预览)： AI 辅助生成提交信息、PR 描述等。
  • Cloud Patches / Code Suggest (预览)： 高级的代码分享和建议功能。
  • Pro 功能在公开仓库上是免费的。对于私有仓库，需要订阅。

基础功能详解与使用步骤：

以下介绍的功能在社区版 (GitLens Community) 中基本都可用，除非特别标注(Pro)。

1. 内联与状态栏 Blame 信息 (Inline & Status Bar Blame)

   • 功能： 在每一行代码的末尾（或状态栏）显示该行最后一次修改的提交作者（缩写名）和修改时间（例如是几天前）。
   • 如何使用：
     • 安装后默认开启。
     • 查看详情： 将鼠标悬停在作者名/时间上，会出现一个丰富的“悬停卡片”(Hover)，展示该提交的完整信息：作者全名、头像（如果集成已连接）、提交时间、提交信息（commit message）、相关的 Issue/PR 链接（如果存在）、以及查看该提交、浏览文件历史、比较变更等操作的快捷按钮。
     • 控制显示：
       • 打开 VS Code 命令面板 (Ctrl+Shift+P 或 Cmd+Shift+P)。
       • 输入并执行Toggle Line Blame 或 Toggle Git CodeLens 来开启/关闭这些注释。

2. 文件顶部 CodeLens

   • 功能： 在文件编辑器的顶部区域显示关键信息。
     • Recent Change： 显示该文件最近一次修改的提交作者和时间。
     • Authors： 显示参与修改该文件的主要作者数量及最活跃的作者（如果有多位）。
   • 如何使用：
     • 该信息直接显示在文件代码上方。
     • 将鼠标悬停在Recent Change或Authors上，同样会显示详细的“悬停卡片”(Hover)，内容类似于行尾 Blame 的卡片，提供文件级别的提交信息和操作入口。点击这些信息通常可以打开相关视图。

3. 文件级别注释 (File Annotations)

   • 功能： 对整个文件进行可视化标记。
     • File Blame： 在每一行代码的开头显示该行的最后修改作者（通常显示在编辑器左侧装订线 gutter 区域）。
     • File Changes： 在左侧装订线显示每行代码是何时（如提交序号）被修改或添加的。
     • File Heatmap： 用颜色深浅（通常是蓝色系）直观表示一行代码的“年龄”，越新（最近修改）颜色越深/亮，越旧颜色越浅/暗。
   • 如何使用：
     • 打开要查看的文件。
     • 打开 VS Code 命令面板 (Ctrl+Shift+P 或 Cmd+Shift+P)。
     • 输入并执行对应的命令：Toggle File Blame， Toggle File Changes， 或 Toggle File Heatmap。执行一次开启，再执行一次关闭。
     • 快捷键通常可以在命令面板查看或设置。

4. 修订导航 (Revision Navigation)

   • 功能： 轻松查看文件或代码块的早期版本（历史记录）。
   • 如何使用：
     • 打开一个文件。
     • 在文件编辑器的右上角（标题栏区域），您会看到一个类似时钟/历史记录的图标，旁边可能显示HEAD（表示当前最新版本）。
     • 查看上一个版本： 点击<按钮或时钟图标左边的箭头。
     • 查看下一个版本： 点击>按钮或时钟图标右边的箭头（如果您已经回退到了历史版本）。
     • 鼠标悬停在版本状态上，会显示当前查看的是哪个提交版本（哈希值或标签）。
     • 您可以选择一行或几行代码后再点击这些按钮，查看这些特定行在历史中的变化。

5. GitLens 侧边栏视图

   • 功能： GitLens 在 VS Code 的活动栏（通常是左侧）添加了多个强大的视图面板。
   • 如何访问： 点击 VS Code 左侧活动栏中的 GitLens 图标（狐狸头或 Git 图标，具体取决于您的主题）。
   • 核心视图面板：
     • GitLens:
       • Home (家/主页) (Pro 增强): 工作流程中心（下文详述）。
       • Commits (提交): 按时间倒序列出当前分支的所有提交（包括本地未推送的）。点击提交可以看到详细信息和文件变更。(基本功能免费)
       • Branches (分支): 查看和管理本地及远程分支。右键分支可以进行检出、合并、比较、推送等操作。(基本功能免费)
       • Remotes (远程): 管理远程仓库连接。(基本功能免费)
       • Stashes (储藏): 查看、应用或删除您存储起来的更改。(基本功能免费)
       • Tags (标签): 查看和管理标签。(基本功能免费)
       • Worktrees (工作树) (Pro):
       • Contributors (贡献者): 列出仓库的贡献者及其活动统计。(基本功能免费)
       • Search & Compare (搜索与比较): 强大的提交搜索和分支/标签/提交比较工具。(基本搜索免费, 高级搜索/过滤 Pro)
     • Source Control (源代码管理): 此部分是 VS Code 内置面板的增强，整合了 GitLens 的一些功能。

6. (GitLens Pro 亮点) Home View (工作首页)

   • 功能： 您日常工作流程的指挥中心。围绕三个核心问题构建：
     • Active Work (当前工作)： 显示当前仓库、分支状态、未提交的更改，以及与当前分支关联的 Issue/PR（如果集成已连接并配置 Pro）。一键操作（同步、切换分支、查看更改、打开 Commit Graph）。
     • Launchpad (任务板) (Pro)： 集中展示需要您关注的 Pull Requests（根据您的集成连接）和分配给您的任务（Issue），方便您开始新工作或继续审查。
     • Recent (最近)： 列出您最近处理过的分支、工作树 (Pro) 或 PR，方便您快速切换回上下文。
   • 如何使用：
     • 点击 VS Code 活动栏中的 GitLens 图标。
     • 默认打开的就是 Home 视图标签页。
     • 在 Active Work 部分使用操作按钮。
     • 在 Launchpad 点击 “Start Work on an Issue” 或 “View Pull Request”。
     • 在 Recent 查看并点击项目跳转。
     • 集成连接： 通常在 Home View 顶部或设置中有提示/按钮让您连接 GitHub/GitLab/Jira 等账号，以解锁相关功能（特别是 Launchpad 和 Active Work 中的 Issue/PR 关联）。

7. (GitLens Pro 亮点) Commit Graph (提交图谱)

   • 功能： 以图形化的方式直观展示仓库的分支结构、提交历史、标签、合并等。远胜于 git log --graph。提供强大的搜索、过滤、右键菜单操作（检出、合并、变基、创建分支/标签等）。
   • 如何打开：
     • 方法一 (推荐)： 在 Home View -> Active Work 部分，点击右侧的小图表图标 (通常在分支信息旁边)。
     • 方法二： 打开 VS Code 命令面板 (Ctrl+Shift+P 或 Cmd+Shift+P)，输入并执行 Toggle Commit Graph。执行 Toggle Maximized Commit Graph 可切换最大化视图。
     • 方法三： 在底部面板区域可能默认或可以配置一个更紧凑的 Commit Graph 视图。
   • 基本操作：
     • 缩放： 鼠标滚轮或触摸板手势。
     • 平移： 按住鼠标左键拖拽画布。
     • 查看提交详情： 点击某个提交节点。
     • 执行操作： 右键点击提交节点、分支标签或空白区域，会弹出丰富的上下文菜单（检出、创建分支、合并、变基、比较、查看文件历史等）。这是图形化操作替代 Git 命令的核心。
     • 搜索： 使用视图顶部的搜索框搜索提交信息、作者、文件、哈希值等 (基本搜索免费，高级过滤 Pro)。

入门建议：

1. 安装： 直接在 VS Code 扩展市场搜索 GitLens 并安装。
2. 初次探索： 打开一个 Git 仓库中的文件。
3. 看内联信息： 观察行尾的状态栏或装订线，悬停查看详情。
4. 看文件顶部： 留意 Recent Change 和 Authors 信息，悬停查看。
5. 尝试导航历史： 在文件编辑器右上角尝试点击箭头回退文件历史。
6. 打开 Home View： 点击左侧 GitLens 图标，浏览 Home 页面的各个部分。
7. 打开 Commit Graph (即使免费版也可体验基本视图)： 通过 Home 页图标或命令面板打开，感受图形化历史。
8. 连接集成 (可选但推荐)： 在 Home View 或设置中连接您的 GitHub/GitLab 等账号。
9. 查阅设置： VS Code 设置 (Ctrl+, or Cmd+,) 中搜索 gitlens，有大量选项可以定制 GitLens 的行为和外观。根据个人喜好调整 blame 风格、日期格式、热图颜色等。

总结：

GitLens 将深度 Git 集成无缝地带入您的编辑器。从基本的 “谁改了这行代码？”（blame 信息），到高效的代码历史导航（修订导航），再到可视化的分支管理（Commit Graph）和现代化的团队协作流程管理（Home View, Launchpad，Cloud Patches），它极大地提升了开发者的体验和工作效率。社区版的功能已经非常强大，足以满足个人了解历史和基础 Git 操作的需求。而 GitLens Pro 则在团队协作、高级工作流管理和私有仓库支持上提供了更大的价值。从最基础的内联 blame 开始探索，逐步熟悉更多功能，您会发现它几乎是现代 VS Code 开发的必备神器。