为了可以重新拥抱 Visual Studio, 我做了一个 vs 版的 gittoolbox

使用 rider 有五六年了,它的编辑体验很棒,可是最近升级到新版本后,经常突然卡死,不知道是公司电脑太烂还是 rider bug 太多。反正卡死多了就想换回 visual studio 试试,习惯了 rider + gittoolbox,突然回到 vs 后还有一点不适应,所以就借鉴了 gittoolbox 做了一个简版的 vs 的 git blame 插件。


Gittoy 的介绍

在 Visual Studio 编辑器中,光标所在行自动内联显示 Git blame 信息 ------ 无需切换窗口,随时知道这一行代码是谁改的、什么时候改的、为什么改。

功能特性

  • 行内 blame 提示:光标停在哪一行,行尾自动显示作者、时间、提交说明
  • 智能定位:提示信息紧跟在"光标位置"和"该行文字末尾"两者中更靠右的一侧,长行不会让提示离光标太远
  • 悬停查看完整信息:鼠标悬停在 blame 文本上,弹出完整 commit hash、作者、精确时间、完整提交说明(懒加载,不影响性能)
  • 点击交互
    • 左键单击:复制 commit hash,带视觉反馈
  • 未保存改动提醒:精确到行级别的脏行追踪 ------ 只有真正被编辑过的行才会提示"此行有未保存的更改",避免整份文件误报
  • 保存自动刷新:文件保存后自动清理缓存并重新拉取 blame 信息
  • 性能优化:文件打开时后台批量预取整份文件的 blame 数据,之后光标移动查询直接读内存,不会每行都新启动一次 git 进程
  • 防抖节流:连续移动光标或快速输入时自动合并请求,避免频繁调用 git
  • 可配置:在 工具 → 选项 → Gittoy 中自定义文字颜色、是否显示提交说明、时间格式、防抖延迟等

环境要求

  • Visual Studio 2022 或更高版本(Community / Professional / Enterprise 均可)
  • 本机已安装 Git,并确保 git 命令在系统 PATH 中可用
  • 打开的项目需要是一个 Git 仓库

方式一:插件市场安装(推荐)

打开 Visual Studio,进入 扩展 → 管理扩展

搜索 Gittoy

点击"下载",关闭 Visual Studio 后会自动完成安装

也可以直接在浏览器中打开 Visual Studio Marketplace 上的 Gittoy 页面 点击"Download"安装。

这种方式支持在"管理扩展"里自动检测并提示新版本更新,无需手动下载文件,是最省心的安装方式。

方式二:下载 .vsix 手动安装

前往 Releases 页面下载最新的 Gittoy.vsix

关闭所有 Visual Studio 窗口

双击 .vsix 文件,按向导完成安装

重新打开 Visual Studio 即可生效

适合无法访问插件市场,或者想安装特定历史版本的场景。

方式三:源码编译

bash 复制代码
git clone https://github.com/dlforge/Gittoy.git

用 Visual Studio 打开 Gittoy.sln,切换到 Release 配置,重新生成解决方案,生成产物在 bin\Release\Gittoy.vsix

使用说明

安装完成后,打开任意 Git 仓库中的代码文件,将光标移动到任意一行即可看到 blame 信息。首次打开较大的文件时,后台预取整份历史可能需要一两秒,完成后响应会非常流畅。

自定义设置

打开 工具 → 选项 → Gittoy → 常规,可以调整:

选项 说明
正常文本颜色 blame 信息默认显示颜色
未保存行警告颜色 当前行存在未保存改动时的显示颜色
显示提交说明 是否在行内文本中附带 commit summary
时间格式 悬停提示中提交时间的显示格式
防抖延迟(毫秒) 光标移动/编辑后等待多久才真正查询 git,数值越大越省资源但响应更慢

许可协议

本项目基于 MIT License 开源。