.vsix文件命名必须严格匹配平台：Windows含-win32-，macOS含-darwin-universal-或-darwin-arm64-，Linux含-linux-x64-或-linux-arm64-；跨平台安装会报INVALID_SIGNATURE或静默失败，且extension/package.json中os字段明确限定生效平台。
Windows/macOS/Linux 的 .vsix 文件命名差异必须看清楚
同一插件在不同系统上发布的 .vsix 文件名往往不同，尤其对底层依赖强的插件（如 ms-vscode.cpptools、vadimcn.vscode-lldb）。直接拿 Windows 版本去 Linux 上装，会报 INVALID_SIGNATURE 或静默失败。
- Windows 版通常带
-win32-或-win32-x64-（如cpptools-win32-x64-1.19.0.vsix） - macOS Universal 版含
-darwin-universal-，Apple Silicon 专用版可能是-darwin-arm64- - Linux 版常见
-linux-x64-或-linux-arm64-，注意区分 glibc 版本（部分企业内网服务器仍用旧版 CentOS，需确认是否支持glibc >= 2.28）
别信文件名里没写平台的“通用包”——VS Code 不支持跨平台 .vsix，解压后 extension/package.json 里的 os 字段会明确限定生效平台。
Linux 离线安装前必须确认 vscode-server 兼容性
如果你用的是 Remote-SSH 连内网服务器，光装客户端插件不够。服务器端的 vscode-server 必须和本地 VS Code 版本严格匹配，否则插件功能（尤其是调试器、IntelliSense）会直接失效。
- 查本地 VS Code 的 Commit ID：
Help → About里第一行末尾那串 40 位哈希值（如5a1b23d...） - 下载对应 server 包：
https://update.code.visualstudio.com/commit:<code>5a1b23d.../server-linux-x64/stable - 手动解压到服务器的
~/.vscode-server/bin/<code>5a1b23d...目录，确保权限为当前用户可读写
很多团队卡在这一步：插件明明装上了，但 Remote-SSH 连上去后 Python 调试器不启动、C++ 头文件找不到——根源是 server 和 client 的 Commit ID 对不上。
macOS M 系列芯片用户慎用 Intel 插件包
虽然 macOS Universal .vsix 声称兼容 Apple Silicon，但实际运行时仍可能调用 x86_64 的二进制依赖（比如某些 Python 扩展背后的 pyls 或 clangd）。结果就是插件显示已启用，但语言服务始终不响应。
- 优先从 GitHub Releases 下载明确标注
-darwin-arm64-的版本（如python-darwin-arm64-2026.6.123456.vsix） - 若只有 Intel 版，可用 Rosetta 启动 VS Code，但性能下降明显，且部分调试器（如
CodeLLDB）会直接报architecture mismatch - 验证方式：打开命令面板（
Ctrl+Shift+P），输入Developer: Toggle Developer Tools，在 Console 里搜arm64或x64，看加载的 native 模块是否匹配
离线环境里最常被忽略的依赖项校验
装完插件没反应？不是版本不对，而是缺了硬编码在 package.json 里的 extensionDependencies。比如装了 esbenp.prettier-vscode 却没装 bradlc.vscode-tailwindcss，Tailwind 类名格式化就完全不触发。
- 解压
.vsix（它本质是 zip），打开extension/package.json - 检查
"extensionDependencies"数组，逐个确认这些插件 ID 是否已在目标机器上安装 - 用
code --list-extensions核对，ID 格式是publisher.name（如ms-python.python），不是插件显示名
这个字段不会在 Marketplace 页面展示，也不出现在安装日志里，只能手动翻包——多数离线部署失败，问题就藏在这里。
