离线安装vue插件核心是volar必须启用且vetur禁用，否则补全失效、cpu爆满、类型推导错误；volar离线需提前在有网环境触发下载server并完整拷贝扩展目录，版本与vscode严格匹配，拖入.vsix须确保路径无空格、目标为编辑区且手动启用。
离线环境装 Vue 插件，核心就一条：Volar 必须装，Vetur 必须禁用，否则补全失效、CPU 爆满、类型推导全错——这不是兼容性问题，是设计冲突。
为什么 Volar 在离线环境下特别容易“装了等于没装”
离线时 Volar 不会报错，但首次打开 .vue 文件后状态栏卡在 “Starting Volar server…” 或输出面板持续显示 Failed to fetch。这是因为插件默认要下载 volar-server 二进制（含 vue-language-server），而该行为走外网且无 fallback。
- 必须提前在有网机器上完整触发一次：打开任意
.vue文件 → 等状态栏变绿 → 关闭 VSCode - 然后拷贝整个扩展目录：
~/.vscode/extensions/johnsoncodehk.volar-1.12.0/（Linux/macOS）或%USERPROFILE%\.vscode\extensions\johnsoncodehk.volar-1.12.0\（Windows） - 不能只拷
.vsix，也不能只拷node_modules子目录；必须是解压后的完整文件夹，且目录名严格匹配publisher.name-version格式 - 拷完后，内网机上需彻底退出 VSCode（包括托盘进程），再启动，否则缓存不刷新
code --install-extension 安装 Volar.vsix 为什么总提示 “not compatible with Code”
这个错误几乎全是版本号硬性不匹配导致的，VSCode 不会降级适配，也不会提示“请升级 VSCode”。Volar 的 package.json 中 "engines": {"vscode": "^1.85.0"} 要求主版本 ≥ 1.85，而你的本地是 1.84.2 就直接跳过加载，连日志都不写。
- 查本地版本：终端运行
code --version，取第一段（如1.84.2→ 主版本是1.84） - 查插件要求：解压
volar.vsix（它本质是 zip），打开extension/package.json，看engines.vscode - ARM Mac 装 x64 版本的
.vsix也会触发同一报错，需确认插件页是否提供darwin-arm64构建包 - Windows 下路径含空格却没加引号，例如
code --install-extension C:\my ext\volar.vsix，会被解析成两个参数，报错信息反而误导为兼容性问题
拖 .vsix 进 VSCode 主窗口没反应？三个静默失败条件
这是离线场景下最高频的“假失败”，VSCode 不弹窗、不报错、不写日志，只是默默忽略。
- VSCode 没获得系统焦点：任务栏图标未高亮，或被其他窗口遮挡；先点一下编辑器空白区再拖
- 处于全屏模式或远程桌面（RDP/TeamViewer）中：这类环境常拦截拖放事件，退出全屏或改用命令面板
- 拖的是已解压的文件夹或重命名过的
.zip：VSCode 只识别原始未解压的.vsix包；用unzip -l volar.vsix应看到顶层是extension/目录 - 拖入位置错误：必须拖进主编辑区（白底代码区），不是侧边栏、不是设置页、不是终端面板
最易被忽略的一点：插件列表里显示“已安装”不等于“已启用”。Volar 默认安装后是禁用状态，必须手动点击右上角「启用」按钮，或重启 VSCode 才真正激活——尤其在离线环境，没有自动启用逻辑。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
