Version Lens 插件可在 VSCode 中实时显示 npm/pip 等依赖的最新版本，需安装插件、配置包管理器支持、解读行尾提示、调整更新频率与代理，并排查解析失败原因。
如果您在使用 VSCode 开发项目时希望实时了解当前安装的 npm 或 pip 包是否存在更新，Version Lens 插件可直接在代码中高亮显示依赖项的最新可用版本。以下是启用并有效使用该插件的具体操作步骤：
本文运行环境：MacBook Pro，macOS Sequoia。
一、安装 Version Lens 插件
Version Lens 是一个轻量级的 VSCode 扩展，通过解析 package.json、requirements.txt 等依赖文件，在编辑器内嵌入版本提示信息。它不修改项目结构，仅提供只读视图增强。
1、打开 VSCode，点击左侧活动栏的扩展图标（或按快捷键 Ctrl+Shift+X）。
2、在搜索框中输入 Version Lens。
3、在搜索结果中找到作者为 Pavel Doležal 的官方插件，点击“安装”按钮。
4、安装完成后，重启 VSCode 以确保插件完全加载。
二、启用对不同包管理器的支持
Version Lens 默认支持 npm 和 yarn，但需手动开启对 pnpm、pip、poetry 等工具的支持，否则相关依赖行不会显示版本提示。
1、按下 Cmd+,（macOS）或 Ctrl+,（Windows/Linux）打开设置界面。
2、在搜索框中输入 versionlens.packageManagers。
3、点击“在 settings.json 中编辑”，在数组中添加 "pnpm" 或 "pip"（根据项目实际使用工具选择）。
4、保存文件后，重新打开含依赖声明的文件（如 requirements.txt），版本提示将立即生效。
三、识别并解读版本提示标记
插件会在依赖行末尾插入内联装饰文本，包含当前版本、最新稳定版及可选预发布版信息，所有提示均基于官方注册表实时查询。
1、在 package.json 的 "dependencies" 区域中，找到类似 "lodash": "^4.17.21" 的条目。
2、行尾将显示灰色小字：v4.17.21 → v4.17.22，其中箭头右侧为最新稳定版。
3、若存在兼容性更高的主版本（如 v5.x），且符合 semver 范围，提示中会额外标注 (major) 标识。
四、配置自动检查频率与网络代理
Version Lens 默认每 24 小时缓存一次远程版本数据，避免高频请求；当处于企业内网或需要走代理时，必须显式指定代理地址，否则无法获取更新信息。
1、打开 VSCode 设置，搜索 versionlens.updateInterval。
2、将数值修改为 3600000（即 1 小时），适用于频繁迭代的开发场景。
3、在 settings.json 中添加字段："versionlens.proxy": "http://127.0.0.1:8888"（替换为实际代理地址）。
4、保存后，插件将在下次依赖文件重载时应用新配置。
五、排查无版本提示的常见原因
若依赖行未出现任何版本提示，通常并非插件故障，而是因语法格式、路径或权限限制导致解析失败。
1、确认依赖文件位于工作区根目录下，或已在 versionlens.files 设置中显式添加子路径。
2、检查 package.json 是否存在语法错误，例如逗号遗漏、引号不匹配，VSCode 状态栏会显示 JSON 解析失败警告。
3、对于 poetry.lock 或 Pipfile.lock，确保已启用对应解析器：在设置中将 versionlens.enableLockFiles 设为 true。
4、若项目使用私有 registry（如 Nexus 或 Verdaccio），需在设置中配置 versionlens.registry 指向该地址。
