VS Code Git 行级历史如何从当前行追到提交

在 VS Code 里看到一行旧代码，想追到“是谁在什么提交里改了它”，先不要从仓库级提交列表盲目翻。最短路径是：打开目标文件并把光标放到当前行，用内置 Git blame 找到最近提交；如果还要看这行在多个提交中的连续演变，再用 GitLens 的 Line History。两者的范围不同，混用时最容易误判。

官方地址：https://code.visualstudio.com/

只查最近一次归属，用 VS Code 的 Git blame；要查看选中行的多次修改，使用 GitLens Inspect → Line History；最后进入 Commit Details 核对文件 diff，才算追溯完成。

先分清：行归属、文件历史和连续行历史

VS Code 的 Source Control 视图、Source Control Graph 和 Explorer → Timeline 面向不同范围。Timeline 显示当前活动文件的提交与本地保存事件；Git blame 把某一行对应到最近一次修改它的提交；GitLens 的 Line History 则把选中行相关的多个提交列出来。比如一行配置解析逻辑经历过“增加默认值、修复空值、调整错误提示”三次修改，单看 blame 只能看到最后一次。

示例使用一个已经提交过的项目文件。若文件只有未提交内容，先在编辑器中区分工作区改动；未提交改动可能改变行号和显示内容，但还没有可供 Git blame 追溯的提交。

第1步：打开文件并把光标放到目标行

在左侧 Explorer 展开仓库目录，点击目标文件。进入编辑器后，把光标放到需要追溯的那一行，不要只在文件空白处停留。先看底部状态栏的分支名称，再确认面包屑中的文件路径；多根工作区里同名文件很多，路径确认比直接点历史更重要。

看到编辑器中有明确的当前行高亮，且文件来自 Git 仓库后再继续。若左侧没有仓库标记，先检查文件是否位于工作区根目录下，或确认 Git 是否已安装并能被 VS Code 识别。

第2步：用内置 Git blame 定位最近提交

按 Command/Ctrl + Shift + P 打开命令面板，输入并执行 Git: Toggle Git Blame Editor Decoration。开启后，编辑器会在行尾显示当前行最近一次修改的作者、日期和提交摘要。把鼠标移到这段注释上，可看到更完整的提交信息；若界面提供提交标识入口，点击它进入提交详情。

这里得到的是“最近归属”，不是完整时间线。代码行被后续提交整体重写、合并或移动后，blame 可能只指向最后一次有效修改；不要把它当成这行从诞生到现在的全部记录。

第3步：用 GitLens Line History 查看选中行的连续变化

如果需求是“这行之前怎么改过”，在 VS Code 扩展视图搜索并安装 GitLens — Git supercharged。安装后回到文件，在编辑器中选中目标行，然后打开左侧 GitLens 图标进入 Inspect。在文件历史区域切换到 Line History；如果该视图被隐藏，可在 GitLens 视图菜单中重新显示。GitLens 官方文档说明，Line History 默认隐藏并且只针对当前文件中选中的行。

官方扩展地址：https://marketplace.visualstudio.com/items?itemName=eamodio.gitlens

逐项点击列表中的提交，观察右侧或编辑器中新开的 Commit Details。如果列表为空，先确认确实选中了代码行、文件已保存到 Git 历史，并检查当前 Line History 使用的是哪个分支或基准引用。空列表不等于“这行从未改过”，也可能是选择范围、分支或未提交状态不匹配。

第4步：打开提交详情，核对到文件 diff

在 Commit Details 中至少核对四项：提交标题或短 SHA、作者和时间、发生变化的文件路径、diff 中对应的新增或删除行。绿色通常表示新增，红色通常表示删除；如果只看到提交信息而没有目标文件，说明你打开的是仓库级提交概览，还需要展开文件列表或点击目标文件。

需要补看文件级记录时，在 Explorer 中展开 Timeline，过滤到 Git commits，再选择某个事件查看文件变化。它适合确认文件演变，不应替代 Line History 的行级筛选。最后把短 SHA、文件路径和关键 diff 位置一起记录，后续复盘会比只保存作者姓名可靠。

常见问题

VS Code 内置 Git 能直接列出一行的全部历史吗？

内置 Git 可以通过 blame 找到当前行最近的提交，也能用 Timeline 查看文件历史；要对选中行列出多次相关提交，使用 GitLens Line History 更直接。

为什么打开 Timeline 后看不到我想要的行？

Timeline 的对象是当前文件，不是当前光标行。请改用 GitLens Line History；如果只想知道最后一次修改者，开启 Git blame 即可。

当前行有未提交修改，还能追溯吗？

可以先看 blame 的已提交归属，但未提交内容尚未进入 Git 历史。先区分工作区 diff，再决定追溯旧提交还是先完成一次有意义的提交。

完成确认

当你能同时说清“当前行最近对应哪个提交”“Line History 中还有哪些相关提交”以及“目标文件在提交 diff 中确实发生了变化”，这次 VS Code Git 行级追溯才真正闭环。若只看到一个作者标签，完成的只是 blame 定位，不是完整历史核对。