Version Lens 是 vscode 插件,在 package.json 依赖行末和 import 语句旁内联显示当前 / 最新版本及更新状态;用绿 / 黄 / 红三色标识更新级别,支持 npm/pnpm/yarn 及 monorepo,可自定义语言、排除包、刷新频率等。

Version Lens 是 VSCode 中一个轻量但非常实用的插件,它能在代码中直接显示你所用依赖包的当前版本、最新版本,甚至是否过时——所有信息都内联在 package.json 或导入语句旁,无需离开编辑器查 npm 或 gitHub。
它在哪显示版本信息?
安装启用后,Version Lens 会自动在以下位置添加小字标注:
- package.json 中
"dependencies"和"devDependencies"的每一行末尾,显示当前版本 + 最新稳定版(如 v1.2.3 → v2.0.1) - typescript/javaScript 文件 的 import 语句旁(需配合
node_modules解析),例如:import {debounce} from 'lodash'; // v4.17.21 → v4.17.22 - 支持 pnpm、yarn 和 npm,对 workspace 中的 monorepo 也基本友好
怎么知道该不该升级?
Version Lens 默认用颜色和箭头直观提示:
- 绿色 :已是最新版,或仅补丁更新(如 v1.2.3 → v1.2.4)
- 黄色 :有次要版本更新(如 v1.2.3 → v1.3.0),可能含向后兼容的新特性
- 红色 :有主版本更新(如 v1.2.3 → v2.0.0),通常含不兼容变更,建议点开链接看 changelog
鼠标悬停在版本号上,会显示发布时间、是否为 latest / next 标签,以及跳转到 npm 页面的快捷链接。
可以自定义哪些行为?
在 VSCode 设置中搜索 version lens,常用调整项包括:
- 启用 / 禁用特定语言支持 (如关掉 python 或 go 的版本检查,只留 JS/TS)
- 隐藏预发布版本提示 (避免被
v3.0.0-beta.2干扰) - 设置检查频率 (默认每 6 小时刷新一次远程版本,可改为手动触发)
- 排除某些包 (例如本地 link 包或私有 registry 包,加到
versionlens.ignoredPackages)
基本上就这些。它不改代码、不自动升级、也不弹窗打扰,只是安静地把关键信息“摆”在你该看的地方——省去反复切网页、记版本、猜兼容性的力气。