最可靠的方式是通过「关于」窗口查看版本号,其顶部显示的“版本: 1.87.2”为权威信息,不依赖插件、网络或环境变量;其次可用code --version命令获取版本号与提交哈希。

VS Code 版本号直接看「关于」窗口最可靠
打开 VS Code 后,帮助 菜单 → 关于 Visual Studio Code(macOS 是 VSCode 菜单 → 关于),弹窗顶部显示的 版本: 1.87.2 就是当前运行版本。这个方式不依赖插件、不触发网络请求,也不受终端环境变量干扰,是最权威的来源。
常见错误现象:有人在命令面板里搜 version,选中 查看版本 命令,结果只看到一行简略信息(如 1.87.2 (system setup)),但漏掉了构建时间、提交哈希等关键字段——这些只有「关于」窗口才完整展示。
- Windows/Linux 快捷键:按
Alt呼出菜单栏,再按H→A - macOS 注意:
关于不在帮助下,而在屏幕顶部的VSCode菜单里 - 如果菜单栏被隐藏(比如全屏或设置了
menuBarVisibility: "toggle"),先按Alt(Win/Linux)或Ctrl+Cmd+P(macOS)唤出命令面板,输入Toggle Menu Bar恢复显示
终端里查版本:用 code --version,别用 vscode --version
code --version 是官方 CLI 工具提供的标准命令,输出两行:第一行是版本号(如 1.87.2),第二行是提交哈希(可用于排查是否为预发布版或自编译版本)。它比 GUI 更适合脚本调用或 CI 场景。
容易踩的坑:
- 误输成
vscode --version:系统会报command not found,因为可执行文件名是code,不是vscode - 在 VS Code 集成终端里运行却得到旧版本:说明你装了多个 VS Code(比如用户版 + 系统版),
code命令指向的是另一个安装路径;可用which code(macOS/Linux)或where code(Windows)确认 - 某些 Linux 发行版(如 Ubuntu Snap 安装)下
code --version可能卡住或无响应——这是 Snap 的权限限制,此时退回「关于」窗口更稳妥
插件开发时读取版本:用 vscode.version API
如果你在写 VS Code 扩展,需要根据宿主版本做兼容性判断(比如 1.86+ 才支持某新 API),直接从模块导入后访问 vscode.version 即可,返回字符串如 "1.87.2"。
注意点:
- 这个值是启动时注入的静态字符串,不会随 VS Code 升级热更新;重启插件或重载窗口才能获取新值
- 不要用
process.env.VSCODE_VERSION或其他环境变量替代——它不存在,是常见误解 - 做语义化版本比较时,建议用第三方库如
semver,而不是手动split('.'),避免1.10.0 > 1.9.0这类字符串比较翻车
为什么不能只信「设置同步」或「扩展市场」显示的版本?
VS Code 设置同步服务(Settings Sync)和扩展详情页有时会显示「最新可用版本」,但这只是远程服务器上的版本号,和你本地运行的实际版本无关。尤其当你禁用自动更新、使用 Insiders 版本、或通过企业策略锁定版本时,两者可能差好几个小版本。
真正影响行为的是本地二进制文件的版本。比如你看到扩展市场写着「支持 VS Code 1.85+」,但你本地是 1.84.3,哪怕 UI 上没报错,某些 API 调用仍可能静默失败——这时候必须以 code --version 或「关于」窗口为准。
最易被忽略的一点:VS Code 的「版本号」包含构建渠道信息。1.87.2 后面若跟着 (Universal)、(ARM64) 或 (system setup),意味着架构或安装方式不同,某些原生插件(如 C/C++ 的调试器)可能因此不兼容,光看数字不够。











