离线安装 Vue/React 前端调试包必须同时部署 .vsix 插件和对应平台的 language server 二进制文件，否则 LSP 服务无法启动，导致语法高亮、校验等功能失效；需确保 VSCode 版本、系统架构匹配，并验证 server/ 目录存在且可执行。
离线装前端框架调试包（如 Vue/React 的语言服务器）不能只装 .vsix 文件——必须让 language server 二进制落地，否则打开文件就是“Loading…”或零功能。
为什么 Volar / ESLint 插件装了但不报错也不高亮
这不是安装失败，而是前端调试包普遍依赖 LSP（Language Server Protocol）服务，这些服务在首次打开对应文件（.vue、.tsx）时才懒加载。离线环境会卡在 Failed to fetch 或静默跳过。
- 典型现象：
<template>区域无语法高亮、无补全，但<script setup>里 TypeScript 代码正常 → 说明volar-server没启动 - ESLint 插件显示已启用，但不校验代码 →
eslint-language-server未运行，输出面板里有spawn ENOENT - Vue 插件用的是旧版
vue-language-server（Vetur），而新项目需要volar-server，二者不兼容，不能共存
离线部署 Volar / Vue Language Features 的硬性条件
只拷 .vsix 文件等于只装了个空壳。真正生效要同时满足三项：
-
VSCode --version输出的主版本号 ≥ 插件package.json中"engines": {"vscode": "^1.85.0"}声明的最低版本（如1.84.2就不够） - 架构匹配：ARM Mac 必须用带
darwin-arm64后缀的.vsix或 server 二进制；x64 机器不能混用 arm64 版本 -
volar-server或vue-language-server二进制必须存在于扩展目录下的server/子目录中，路径示例：~/.vscode/extensions/volarjs.volar-1.12.0/server/volar-server
两种能落地的离线方案（选一个）
推荐优先走「预热 + 整目录迁移」，它最省事也最可靠；只有 .vsix 文件时再考虑手动补 server。
PigX UI 前端开发
下载
PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。
立即学习“前端免费学习笔记（深入）”；
-
方案一：有网机器预热 + 拷整目录
在一台网络通畅、VSCode 版本和架构完全一致的机器上：
– 安装
volar.volar-1.12.0.vsix– 打开任意.vue文件，等右下角状态栏出现Volar: Ready– 全量拷贝整个扩展目录（含node_modules和server/下的可执行文件）到内网机对应路径：%USERPROFILE%\AppData\Roaming\Code\Extensions\（Windows）或$HOME/.vscode/extensions/（macOS/Linux） -
方案二：手动解压 + 补 server
– 用
unzip volar.volar-1.12.0.vsix -d volar-unpacked解压 – 去 GitHub Releases 页面下载对应平台的volar-server（如volar-server-darwin-arm64） – 放入volar-unpacked/server/，确保权限可执行（Linux/macOS 上chmod +x） – 重命名目录为volarjs.volar-1.12.0，移入extensions/
验证是否真能用，不是只看“已安装”
扩展面板打勾 ≠ 可用。必须做三件事：
- 打开命令面板（
Ctrl+Shift+P），输入Volar: Show Output Channel或ESLint: Show Output Channel，看输出里有没有报spawn ENOENT或连接超时 - 打开一个真实
.vue或.tsx文件，观察状态栏右下角是否显示Volar: Ready或ESLint: Running - 检查
extensions/目录下对应插件子目录里是否存在server/，且里面是二进制文件（非空 JS 脚本）；ls -l server/或dir server\可快速确认
最容易被忽略的是 server 二进制的平台适配和执行权限——ARM 机器跑 x64 server 会静默失败，Linux 上没 +x 权限会导致 spawn 失败，这些都不会弹错误提示，只会让插件“看起来装好了”。
