离线安装Volar插件需确保三要素齐备：VSCode版本≥package.json声明的最低版本（如1.85.0）、架构匹配（如ARM Mac需darwin-arm64版）、语言服务器二进制（volar-server）已存在于extensions/volarjs.volar-*/server/目录；仅安装.vsix仅完成前端部分，必须通过预热+整目录迁移或手动补全server才能真正生效。
离线安装 VSCode 插件不能只装 Vue 相关扩展就完事——Volar、Vue Language Features 这类核心插件依赖 LSP 服务和 TypeScript 类型系统，不提前拉取 native 二进制或预热语言服务器，打开 .vue 文件时只会卡在“Loading…”状态。
怎么确认 Volar 插件在离线环境真能用
离线装上 volar.vue 后，VSCode 扩展列表显示“已安装”只是第一步。真正生效要满足三个条件：VSCode 版本 ≥ package.json 中 "engines": {"vscode": "^1.85.0"} 声明的最低版本、架构匹配（ARM Mac 必须用 darwin-arm64 构建版）、且语言服务器二进制已存在。
- 先解压
volar.volar-1.12.0.vsix，运行unzip -p volar.volar-1.12.0.vsix extension/package.json | grep engines查版本要求 - 对比本地
code --version输出（如1.84.2→ 主版本是1.84），若低于1.85，插件会被静默跳过加载 - 检查
~/.vscode/extensions/volarjs.volar-1.12.0/server/（Linux/macOS）或%USERPROFILE%\.vscode\extensions\volarjs.volar-1.12.0\server\（Windows）下是否有volar-server或volar-server.exe—— 没有就说明只装了插件壳，没带语言服务
离线部署 Volar 的两种可靠路径
直接拖 .vsix 进 VSCode 窗口最简单，但对 Volar 这类含 native server 的插件，它只完成前端部分安装；要完整可用，必须让 server 二进制落地。
-
推荐方式：有网机器预热 + 整目录迁移 —— 在一台能联网的同版本 VSCode 上安装
volar.volar-1.12.0.vsix，然后打开任意.vue文件，等状态栏右下角出现Volar: Ready，再把整个volarjs.volar-1.12.0/目录拷到内网机对应extensions/路径下 -
应急方式：手动解压 + 补 server —— 若只有
.vsix，先用unzip volar.volar-1.12.0.vsix -d volar-unpacked解压，再从官网 GitHub Release 页面下载对应平台的volar-server（如volar-server-darwin-arm64），放入volar-unpacked/server/，最后按 ID+版本重命名并移入extensions/
为什么装了 Volar 还没有 Vue 模板语法高亮
常见现象是打开 .vue 文件后，<template> 区域无高亮、无补全，但 <script setup> 里 TypeScript 代码正常——这说明 Volar 的 template parser 没启动，大概率是 typescript-vue-plugin 或 vue-tsc 未就位。
立即学习“前端免费学习笔记（深入）”；
- Volar 默认会尝试从 npm registry 下载
@vue/typescript-plugin，离线时失败且无提示 - 解决办法：在有网机器上执行一次
vue-tsc --noEmit（需全局安装），触发插件缓存；或手动下载@vue/typescript-plugin的node_modules子集，放进volarjs.volar-1.12.0/node_modules/ - 验证是否生效：打开命令面板（
Ctrl+Shift+P），输入Volar: Show Server Log，看输出里有没有Template parse started或报错Failed to load @vue/typescript-plugin
离线环境下 Volar 和 Vetur 冲突怎么办
如果内网机器之前装过 octref.vetur，即使已禁用，Volar 仍可能因类型注册冲突导致 <script setup> 无法识别 defineProps。这不是兼容性问题，而是 VSCode 同一语言 ID（vue）下只能激活一个语言服务器。
- 必须彻底卸载
octref.vetur：用code --uninstall-extension octref.vetur，不能只点「Disable」 - 检查工作区设置：
.vscode/settings.json里不能有"vetur.*"配置项，否则 Volar 会降级为只处理<script> - 重启 VSCode 后，在
Output面板切换到Volar通道，确认首行是Starting Volar server...，而非Fallback to Vetur mode
离线部署 Vue 开发支持，最难的不是装插件，而是让所有隐式依赖（LSP server、TS plugin、schema 文件）都落在正确路径、且版本对齐。任何一步跳过预热或手动补全，都会变成“列表里有，但写代码时没反应”的假成功状态。
