VSCode离线插件安装指南_手动添加Vue代码辅助工具【步骤】-VSCode-PHP中文网

离线安装vue插件失败主因是版本不匹配、.vsix损坏或缺失lsp服务；需确认vscode≥1.77且架构一致，拖拽前确保工作区已加载并有焦点，完整复制含server子目录的插件文件夹而非仅.vsix。

vscode离线插件安装指南_手动添加vue代码辅助工具【步骤】

离线安装 Vue 相关插件（如 Volar、Vetur）失败，90% 是因为版本不匹配、.vsix 文件损坏、或漏掉了语言服务器（LSP）依赖 —— 它们不会报错，但 .vue 文件打开后没有语法高亮、跳转、补全。

Volar 要求 VSCode ≥ 1.77（部分新版需 ≥ 1.85），且架构必须一致（arm64 Mac 不能装 x64 构建的 vsix）。不匹配时，code --install-extension 会静默跳过，GUI 拖拽也无反应。

在 VSCode 中按 Ctrl+Shift+P → 输入 About → 查看 Version（如 1.85.2）和括号内架构（如 arm64）
下载 volarjs.volar-1.14.0.vsix 后，用 unzip -p volar.vsix extension/package.json | grep engines（macOS/Linux）或 7-Zip 打开查看 "vscode": "^1.85.0"
若本地是 1.84.3，就得降级下载 volar-1.13.x 版本，不能硬装

VSCode 空白启动窗口、远程 SSH 连接未就绪、或任务栏图标未高亮时，拖 .vsix 进去完全不响应 —— 不是 bug，是设计如此。

vue-component-analyzer

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

下载

必须已打开一个文件夹（哪怕空文件夹），确保工作区已加载
窗口要有系统焦点：点一下编辑器空白处，确认任务栏图标高亮；退出全屏模式
拖的是原始 .vsix 文件，不是浏览器自动改名的 volar.vsix.zip；验证方法：unzip -l volar.vsix 应显示顶层含 extension/ 目录

volarjs.volar 安装只是注册入口，首次打开 .vue 文件时会尝试下载 volar-server（二进制），离线环境卡在状态栏 “Downloading…” 或 Output 面板报 spawn ENOENT。

正确做法：在有网机器上完整走一遍流程 —— 打开 test.vue → 等状态栏不显示下载 → 关闭 VSCode
然后拷整个插件目录：volarjs.volar-1.14.0/（含 server/ 子目录和 volar-server-darwin-arm64 等二进制）到内网机器的 $HOME/.vscode/extensions/（macOS/Linux）或 %USERPROFILE%\AppData\Roaming\Code\Extensions\（Windows）
不能只拷 .vsix，也不能只拷 node_modules；复制完必须彻底退出 VSCode（包括托盘进程），再重开

command not found: code 和 not compatible with Code 是两个最常混淆的问题。前者是环境没配，后者才是版本问题。

运行 code --version 报错？说明 CLI 未注册 → 在 VSCode 中按 Ctrl+Shift+P，输入并执行 Shell Command: Install 'code' command in PATH
报 not compatible？不是 VSCode 太旧，而是 .vsix 的 engines.vscode 字段不满足；用 unzip -p xxx.vsix extension/package.json 查声明值
Windows 路径含空格或中文？必须加英文双引号：code --install-extension "C:\my ext\volar.vsix"