离线安装语法高亮插件（如Vue/Python）不生效，主因是语言服务器（LSP）未落地；需在有网机触发首次启用并整目录迁移含server子目录的扩展文件夹，且彻底退出VSCode刷新缓存。
能离线装，但语法高亮插件（比如 Vue/Python/HTML 相关）离线装完大概率不生效——不是没装上，而是语言服务器（LSP）根本没落地。
拖拽 .vsix 到编辑区没反应？先看这三点
VSCode 不是拒绝安装，是压根没收到信号。常见卡点：
- VSCode 窗口没系统焦点：任务栏图标未高亮，或被全屏/远程桌面（RDP/TeamViewer）遮挡
- 没加载任何工作区：至少打开一个空文件夹，否则拖放事件被忽略
- 拖的是解压过的文件或浏览器改名的
highlight-words.vsix.zip：必须是原始未解压的.vsix文件，用unzip -l xxx.vsix验证顶层含extension/目录
code --install-extension 报错或静默失败？路径和签名是关键
命令行方式最可控，但容错极低：
-
command not found: code→ 不是环境变量问题，是 VSCode 没注册 CLI：按Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH并执行 - 路径必须绝对：
code --install-extension /home/user/ext/highlight-words-0.1.4.vsix（Linux/macOS），Windows 推荐正斜杠写法C:/ext/highlight-words.vsix - 含空格或中文路径必须加双引号：
code --install-extension "C:\my ext\highlight-words.vsix" - 报
INVALID_SIGNATURE→ 离线无法校验证书链，加--allow-unverified参数：code --install-extension highlight-words.vsix --allow-unverified
装上了却没高亮？LSP 二进制根本没跑起来
多数语法高亮插件（如 volarjs.volar、ms-python.python、johnsoncodehk.vetur）只装 .vsix 是“半成品”——前端注册了，但语言服务器（volar-server、pyright-server、vetur-server）没下载或没解压。
- 检查
~/.vscode/extensions/volarjs.volar-1.14.0/server/（macOS/Linux）或%USERPROFILE%\AppData\Roaming\Code\Extensions\volarjs.volar-1.14.0\server\（Windows）下是否有可执行文件（如volar-server或volar-server.exe） - 没有？说明只完成了插件壳安装。正确做法：在有网机器上打开一个
.vue或.py文件，等状态栏显示Volar: Ready或Python: Ready后，把整个插件目录（含server/子目录）拷到内网机对应路径 - 复制完必须彻底退出 VSCode（包括右下角托盘进程），否则缓存不刷新，新 server 不加载
Vue 高亮特别容易翻车？版本和架构必须对齐
Vue 插件离线失效，90% 是因为版本/架构不匹配，且 VSCode 不报错，只静默跳过：
- Vue 2 项目必须用
johnsoncodehk.vetur-0.34.1.vsix；0.35.0+ 只适配 Vue 3，装了也白装 - Vetur 要求 VSCode ≤ 1.79.2；VSCode ≥ 1.80 会直接拒绝加载（因 LSP 协议不兼容）
- Volar 要求 VSCode ≥ 1.85.0（查
package.json中"engines": {"vscode": "^1.85.0"}），本地是 1.84.3 就得降级用 volar-1.13.x - ARM Mac 必须用
targetPlatform=darwin-arm64的 vsix；用 x64 版本不会报错，但volar-server根本不启动
真正麻烦的从来不是“怎么装”，而是“怎么让语言服务器在没网时也跑起来”——它不像前端代码那样静态加载，而是需要 native 二进制、正确路径、完整目录结构，缺一不可。
