VSCode 内置 Git Blame 功能可快速查看代码行的提交者、时间和信息,支持原生切换与 GitLens 增强(悬浮提示、内联注释、文件级 Blame 及自定义格式)。

如果您在 VSCode 中编辑代码时,希望快速确认某一行代码由谁提交、何时修改以及对应提交信息,则 Git Blame 功能可直接提供该行的版本溯源信息。以下是启用并高效使用 Git Blame 功能的具体操作方式:
本文运行环境:MacBook Pro,macOS Sequoia。
一、启用内置 Git Blame 视图
VSCode 自 1.80 版本起已原生集成 Git Blame 能力,无需安装第三方插件即可查看单行作者信息。该功能依托本地 Git 仓库的提交历史,实时解析光标所在行的最近一次变更记录。
1、确保当前文件属于已初始化的 Git 仓库且已被追踪。
2、将光标定位到目标代码行任意位置。
3、按下 Command+Shift+P(Mac)或 Ctrl+Shift+P(Windows/Linux)打开命令面板。
4、输入并选择 Git: Toggle Line Blame。
5、编辑器右侧将显示该行对应的提交哈希、作者姓名、提交日期及简短消息。
二、安装 GitLens 扩展增强 Blame 体验
GitLens 是 VSCode 中最成熟的 Git 增强 工具,其 Blame 功能支持悬浮提示、内联作者标记、提交历史跳转及多行对比,弥补了原生功能在交互与信息密度上的不足。
1、点击左侧活动栏的扩展图标(或按 Command+Shift+X)。
2、在搜索框中输入 GitLens 并选择官方发布的 GitLens — Git Supercharged 扩展。
3、点击“安装”按钮并等待完成。
4、重启 VSCode 后,将光标悬停于任意代码行, 3 秒内自动弹出 Blame 信息浮层,包含头像、作者邮箱、相对时间与提交摘要。
三、使用快捷键触发内联 Blame 注释
GitLens 支持在编辑器行号区域右侧动态插入轻量级 Blame 注释,使作者与时间信息常驻可见,避免频繁悬停或切换视图。
1、确保 GitLens 已启用且当前文件处于 Git 仓库中。
2、按下 Option+Command+I(Mac)或 Alt+Shift+I(Windows/Linux)。
3、编辑器将立即在每行行号右侧显示作者缩写与相对提交时间,如 jdoe 2d。
4、再次执行相同快捷键可关闭内联注释。
四、通过源代码管理视图查看文件级 Blame
当需横向比对整个文件各段落的归属分布时,可通过源代码管理侧边栏调出全文件 Blame 快照,直观识别长期维护者与近期修改者。
1、点击左侧活动栏的源代码管理图标(分支图标)。
2、在“SOURCE CONTROL”标题下方找到当前文件,右键点击该文件名。
3、从上下文菜单中选择 Blame。
4、VSCode 将打开只读的 Blame 专用编辑器,每行左侧显示完整提交哈希、作者、日期与消息前缀。
五、配置 Blame 显示精度与格式
GitLens 允许用户自定义 Blame 信息中显示的字段、时间格式及作者名称解析逻辑,适配不同团队的提交规范与隐私要求。
1、按下 Command+, 打开设置界面。
2、在搜索框中输入 gitlens.blame.format。
3、点击“在 settings.json 中编辑”,在配置对象中添加或修改如下字段:
“gitlens.blame.format”: “${author} • ${ago} • ${message}”
4、保存后,所有 Blame 输出将按新模板渲染,支持的变量包括 ${author}、${authorEmail}、${sha}、${date}、${message}、${ago}。