Vue 3 项目必须用 Volar，Vetur 已停更且与 Volar 冲突；确认方式：查 package.json 中 vue 版本，若为 "^3.x" 或 "3.x" 则必须用 Volar，否则不生效。

Vue 3 项目在离线环境下必须用 Volar，Vetur 不仅失效，还会导致类型推导错乱、F12跳转失败——这不是兼容性问题，是根本无法工作。

怎么确认当前项目该用 Volar 还是 Vetur

打开项目根目录的 package.json，查 dependencies 或 devDependencies 中的 vue 字段：

• 若版本号形如 "vue": "^3.2.0" 或 "vue": "3.4.21" → 必须用 Volar
• 若为 "vue": "^2.6.14" 或 "vue": "2.7.16" → 可用 Vetur（但已停更，不推荐）
• vue 版本未声明？检查 node_modules/vue/package.json 的 version 字段，以实际安装为准

离线安装 Volar 的三个硬性前提

缺一不可，否则 code --install-extension 会静默失败或报 Extension is not compatible：

• VSCode 版本必须匹配：code --version 输出的主版本号（如 1.85.2 → 取 1.85）需满足 .vsix 内 package.json 的 "engines": {"vscode": "^1.85.0"}
• 架构必须一致：Windows x64 不能装 arm64 版本；M1/M2 Mac 必须下载带 darwin-arm64 标识的 .vsix
• 必须从官方市场下载：https://www.php.cn/link/3a3b7accf5943bdf3781f2afa5ccd1eb → 点右上角 Download Extension，别用第三方打包源

装完 Volar 却没反应？检查这三处

状态栏右下角仍显示 Vue (Vetur) 或无任何提示，说明插件未真正激活：

vue-composition-api-best-practices

Vue 3 组合式 API 与 最佳实践，涵盖代码组织、useXxx 模式、组合式函数设计、Store 集成、响应式优化及功能抽取。

下载

立即学习“前端免费学习笔记（深入）”；

• 确认 Vetur 已禁用：命令面板（Ctrl+Shift+P）→ Extensions: Show Enabled Extensions → 搜索 Vetur → 右键 Disable（不是卸载）
• 检查工作区设置：.vscode/settings.json 中删掉所有含 vetur 的字段，例如 "vetur.validation.template"、"vetur.format.defaultFormatter.js"
• 重启 TS 服务：命令面板 → TypeScript: Restart TS server（仅改配置不重启，defineProps 类型推导仍为空）

离线环境里 Vue 版本检测靠的是文件线索，不是自动扫描

VSCode 不会联网查版本，它只认项目里的“证据”：

• 有 package.json 且含 vue 依赖 → 触发 Vue 相关语言支持
• 有 src/App.vue 或 src/main.ts 且含 createApp / defineComponent → Volar 启动模板语义分析
• 没有 vue 依赖但有 .vue 文件？VSCode 默认当纯 HTML 处理，不会启用任何 Vue 功能

所以离线时，vue 必须出现在 package.json 里，否则 Volar 就是摆设。