离线安装vscode插件失败主因是版本不匹配、依赖缺失或文件损坏；需校验.vsix完整性、比对package.json中vscode版本与本地code --version是否兼容、确认架构一致，并为语言插件离线部署lsp服务器等完整依赖目录。
离线安装 VSCode 插件本身不难，难的是装完“看似成功”却无法触发代码片段——尤其是 ms-python.python、esbenp.prettier-vscode 这类依赖语言服务器的插件，根本不会报错，只在状态栏卡着 “Downloading…” 或输出面板静默失败。
拖.vsix进窗口没反应？先确认这三件事
这是最常被当成“安装失败”的假问题。VSCode 只在特定状态下响应拖拽：
- VSCode 必须已加载工作区（哪怕只是打开一个空文件夹），纯启动页或远程 SSH 未就绪时拖放会被静默忽略
- 窗口要有系统焦点（任务栏图标高亮，且没处于全屏模式）
- 拖的是原始
.vsix文件，不是解压后的文件夹、.zip、或双后缀如prettier.vsix.zip
验证方法：用 unzip -l your-extension.vsix 查顶层是否含 extension/package.json；若报错或结构异常，说明文件已损坏。
code --install-extension 报 “not compatible with Code” 怎么查
这个错误只说明版本不匹配，但不会告诉你具体哪一环不对。必须手动比对：
- 运行
code --version，取第一段（如1.85.2→ 看作1.85） - 解压
.vsix，执行unzip -p xxx.vsix extension/package.json | grep engines，看"engines": {"vscode": "^1.80.0"} - 检查架构：Help → About 里括号中是
arm64还是x64？ARM Mac 装 x64 构建的插件会卡在 native 模块加载
注意：^1.80.0 表示最低支持 1.80.0，你用 1.79.2 就会被跳过——不提示、不报错、只是不加载。
插件列表显示“已安装”，但 log / format / IntelliSense 不生效
这不是安装问题，而是离线环境下语言服务缺失的典型症状。关键点：
-
ms-python.python首次打开.py文件会拉pyright；esbenp.prettier-vscode对.js文件会拉prettierCLI —— 这些默认走外网 - 解决办法不是重装
.vsix，而是在有网机器上完整跑一遍：打开对应文件类型 → 等状态栏变绿/输出面板无报错 → 再拷整个扩展目录过去 - 路径必须严格对应：
~/.vscode/extensions/ms-python.python-2024.6.0/（Linux/macOS）或%USERPROFILE%\AppData\Roaming\Code\Extensions\ms-python.python-2024.6.0\（Windows） - 不能只拷
.vsix，也不能只拷node_modules；native 二进制（如pyright-server）藏在子目录里，漏一个就spawn ENOENT
验证方式：打开 Output 面板（View → Output），切换到 Python 或 Prettier 通道，看是否有 Failed to fetch 或 spawn ENOENT。
代码片段不触发？别猜后缀，查 languageId
你在 .tsx 文件里敲 log 没反应，大概率不是片段写错了，而是 VSCode 当前识别的 language ID 是 typescriptreact，而你把片段配在了 javascript.json 或写了 "scope": "tsx"（这个 ID 不存在）。
- 打开命令面板，执行
Developer: Inspect Editor Tokens and Scopes，右上角显示的才是真实Language ID - 通过
Preferences: Configure Language Specific Settings选typescriptreact，它会自动创建typescriptreact.json，直接写snippets对象即可 - 片段 JSON 格式极其敏感：
body必须是数组、不能有尾逗号、变量必须用$1包裹——错一处，整个文件静默失效
真正容易被忽略的是：工作区级片段要放 .vscode/snippets/ 目录下，且该路径必须存在；如果被 files.associations 覆盖了语言映射，片段也完全不会加载。
