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)
基本上就这些。它不改代码、不自动升级、也不弹窗打扰,只是安静地把关键信息“摆”在你该看的地方——省去反复切网页、记版本、猜兼容性的力气。










