必须先确认vscode真实架构：help→about查看括号内标识（如1.85.2 (arm64)），或code --version第二行末尾；插件需同时匹配engines.vscode版本和cpu架构，仅版本对而架构错（如arm64 mac装x64插件）会导致静默失效、lsp下载卡住、跳转提示失灵。
确认本地 VSCode 的架构类型
离线安装插件失败，十次有八次是架构 mismatch —— 比如在 Apple M-series Mac（arm64）上装了 x64 构建的 volarjs.volar-1.14.0.vsix，VSCode 会静默跳过，不报错也不提示。
必须先查清当前 VSCode 运行时的真实架构，不能只看系统或 CPU 类型：
- 打开 VSCode →
Ctrl+Shift+P→ 输入About→ 回车，看弹窗里括号中的内容，例如：1.85.2 (arm64)或1.85.2 (x64) - 命令行验证：运行
code --version，第二行末尾就是架构标识（如arm64） - Windows 用户注意：32 位系统已基本淘汰，但若用的是旧版 Windows Server，
x86架构仍存在，需匹配x86版本的 .vsix
下载前核对 .vsix 的 engines.vscode 和 cpu 架构字段
VSCode 插件的兼容性由两个硬约束共同决定：VSCode 最低版本 + CPU 架构。仅版本对、架构错，或反之，都会导致功能缺失（比如 .vue 文件没语法高亮、跳转失效）。
验证方法（无需解压全量文件）：
- macOS/Linux：用
unzip -p volar.vsix extension/package.json | grep -E "(engines|cpu)" - Windows：用 7-Zip 打开 .vsix → 进入
extension/目录 → 查看package.json中的"engines": {"vscode": "^1.85.0"}和"cpu": ["arm64"]（如有） - 若
package.json中无cpu字段，说明该插件是纯 JS 实现，跨架构通用；但含二进制 LSP server（如volar-server-darwin-arm64）的插件一定带cpu限定
arm64 Mac 装 x64 插件常见假象与真问题
很多用户以为“M系列芯片能跑 x64 程序，所以 x64 插件也能用”，这是危险误解。VSCode 的插件加载机制严格按 process.arch 匹配，不是靠 Rosetta 2 兜底。
典型症状包括：
- 状态栏卡在
Downloading volar-server...，实际没进度 -
Output面板中Volar通道报spawn ENOENT，找不到对应平台的 server 二进制 - 插件显示“已启用”，但
Ctrl+Click跳转、hover提示全部失效
解决路径只有一条：换 arm64 专用构建的 .vsix。比如 Volar 官方发布页里，volarjs.volar-1.14.0.vsix 是通用包，但 volarjs.volar-1.14.0-arm64.vsix（若有）才是正确选择 —— 注意后缀，不是所有插件都提供多架构变体。
Windows 上 x64 vs arm64 的实操分界点
目前绝大多数 Windows 开发机仍是 x64，但 Surface Pro X、部分新锐轻薄本已用高通 Snapdragon（arm64）。二者不可混装：
- 查架构：任务管理器 → “性能”页签 → 看右下角“系统类型”，明确写
基于 x64 的处理器或基于 ARM 的处理器 - VSCode 安装包本身也分架构：从官网下载时，页面会自动推荐匹配项；若手动选错，
code --install-extension会直接拒绝（报not compatible with Code） - 特别注意：某些插件（如 C/C++）的
.vsix内嵌多个平台的调试器二进制，此时它会在package.json中声明"cpu": ["x64", "arm64"]，这种可安全通用
最稳妥的做法：永远以 code --version 输出的架构为准，不凭经验、不猜、不试错 —— 架构错，补全和调试功能大概率残废，且问题极难定位。
