离线安装Vue插件须严格按版本拆分：Vue 2用octref.vetur，Vue 3用vue.volar；需导出带版本号的扩展清单、校验VSCode兼容性、补全隐式依赖（如@vue/language-core）、用绝对路径+--force安装，并在项目级settings.json中明确配置默认格式化器。

离线批量安装 Vue 相关插件，不能靠“装完就用”，必须按 Vue 2 / Vue 3 版本严格拆分、补全隐式依赖、校验 VSCode 版本兼容性，否则 Volar 或 Vetur 会静默不接管 .vue 文件。

Vue 2 和 Vue 3 插件必须分开装，不能混用

离线环境下一旦装错，没有市场一键切换，只能手动卸载重来：

• Vue 2 项目：只装 octref.vetur，ID 是 octref.vetur；vue.volar 在 Vue 2 下无法识别 Options API，格式化会跳过 <script> 块
• Vue 3（尤其含 <script setup>）：必须用 vue.volar，ID 是 vue.volar；vetur 对 Composition API 支持残缺，vetur.format.defaultFormatter.js 等配置根本不起作用
• 两者共存会冲突——VSCode 只启用其中一个作为默认格式化器，另一个被忽略，且无明确报错提示

批量安装前必须导出并校验插件清单

离线环境最怕“这次装的和上次不一样”，而手动记版本不可靠。真正可复现的起点是带 ID 和精确版本号的清单：

• 在已配好插件的机器上运行：code --list-extensions --show-versions > extensions.txt，输出形如 vue.volar@1.12.0 或 octref.vetur@0.34.0
• 别用 code --list-extensions 不带 --show-versions——它只输出 ID，离线安装时很可能拉错版本
• 检查每行插件的 package.json 中 "engines": {"vscode": "^1.85.0"} 是否匹配你本地 VSCode 版本（Help → About 查 Version）
• Vue 插件常依赖其他扩展，比如 vue.volar 隐式依赖 @volar/vue-language-service，必须一并下载对应 .vsix 并列进清单

安装命令必须用绝对路径 + --force，且 VSCode 进程要彻底退出

code --install-extension 看似简单，但离线场景下失败往往卡在进程或路径细节上：

vue-component-analyzer

递归分析 Vue 项目组件依赖，从入口文件生成组件层级图，支持 Vue 2/3，输出组件名、文件路径和属性。适用于分析组件结构、排查依赖或了解项目架构。

下载

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

• Windows 下路径含空格必须加双引号：code --install-extension "C:\ext\vue.volar-1.12.0.vsix"
• Linux/macOS 必须用绝对路径：code --install-extension /opt/vscode-ext/vue.volar-1.12.0.vsix
• 若提示 command not found: code，先在 VSCode 中执行 Shell Command: Install 'code' command in PATH
• 安装前务必确认 VSCode 完全关闭：Windows 查任务管理器有无残留 Code.exe，macOS/Linux 执行 ps aux | grep code 确认无进程
• 同名插件已存在高版本时，默认拒绝降级安装，加 --force 参数强制覆盖：code --install-extension xxx.vsix --force

装完后必须手动配置项目级 .vscode/settings.json

用户级设置在离线环境不可靠（可能被策略禁用），且容易和团队规范脱节。关键配置必须写死在项目根目录：

• Vue 2 项目示例：

  {
    "editor.formatOnSave": true,
    "[vue]": {
      "editor.defaultFormatter": "octref.vetur"
    },
    "vetur.format.defaultFormatter.js": "prettier",
    "vetur.format.options": {
      "tabWidth": 2
    }
  }

• Vue 3 项目示例：

  {
    "editor.formatOnSave": true,
    "[vue]": {
      "editor.defaultFormatter": "vue.volar"
    },
    "volar.format.enable": true,
    "volar.format.options": {
      "tabWidth": 2,
      "useTabs": false
    }
  }

• volar 不读 vetur.format.* 配置；vetur 则必须额外加 "vetur.format.defaultFormatter.js": "prettier" 才能把 JS 块交给 Prettier
• 右下角语言模式显示 “Vue (Vetur)” 或只有 “Vue”？必须点它 → Configure File Association for '.vue' → 选 Volar（不是带括号的旧名）

最容易被忽略的是：离线机器上 node_modules/@vue/language-core 往往缺失——哪怕你不用它写代码，Volar 运行时要读这个包。必须提前在有网机器上 npm install -D @vue/language-core，连同整个 node_modules 拷过去。