离线安装vscode扩展功能不生效的根源是缺失lsp服务或cli二进制依赖。需确保：1. 已打开工作区且窗口有焦点；2. .vsix文件完整未损坏；3. vscode版本、架构与插件兼容；4. 手动复制完整插件目录（含native二进制）而非仅.vsix；5. vue项目须配volar双插件+tsconfig.json并禁用vetur；6. eslint需显式配置probe项。
离线安装 VSCode 扩展本身不难，难的是装完后功能不生效——尤其是语言类插件（如 Python、Vue、ESLint）在内网环境里常卡在“已安装但无提示、无格式化、无 LSP 启动”这一步。这不是操作错了，而是你没补全它真正依赖的二进制文件和运行时上下文。
拖拽 .vsix 到主窗口没反应？先确认这三个硬条件
这是最常被误判为“安装失败”的场景，实际是环境未就绪：
- VSCode 必须已加载一个工作区（哪怕只是打开一个空文件夹），空白启动页或远程 SSH 连接未就绪时拖放会被静默忽略
- 窗口必须有系统焦点（任务栏图标高亮，且没处于全屏模式）
- 拖的是原始
.vsix文件，不是解压后的文件夹、.zip或双后缀文件（如prettier.vsix.zip）
验证方法：unzip -l xxx.vsix 查看顶层是否含 extension/package.json；若报错或结构异常，说明文件已被浏览器/杀毒软件损坏或重命名。
code --install-extension 报 “not compatible with Code” 怎么定位
这个错误只表示版本不匹配，但不会告诉你具体哪一环出问题。需手动比对三处：
- 运行
code --version，取输出中第一位小数点前的版本号（如1.85.2→1.85） - 解压
.vsix，打开extension/package.json，查"engines": {"vscode": "^1.80.0"}字段 - Help → About 里括号中的架构（
arm64/x64）是否与插件构建目标一致（ARM Mac 装 x64 插件会卡在 native 二进制加载）
注意：^1.80.0 表示最低支持 1.80.0，你用 1.79.2 就会被跳过——不报错、不提示，只是不加载。
插件显示“已安装”，但 Python/Vue/ESLint 功能不生效？缺的是 LSP 或 CLI 二进制
像 ms-python.python、vuejs-language-features、dbaeumer.vscode-eslint 这类插件，离线安装后首次打开对应文件时，会尝试下载 pyright、volar-server、eslint CLI 等二进制依赖，默认走外网，结果状态栏一直卡在 “Downloading…”。
- 正确做法：在有网机器上完整启用一次该插件（打开
.py/.vue/.js文件 → 等状态栏变绿 → 不要卸载） - 然后拷整个插件目录（如
ms-python.python-2024.6.0/）到内网机的~/.vscode/extensions/（Linux/macOS）或%USERPROFILE%\AppData\Roaming\Code\Extensions\（Windows） - 不能只拷
.vsix，也不能只拷node_modules——native 二进制（如pyright-server、volar-server）藏在子目录里，漏一个就启动失败
验证方式：打开 Output 面板（View → Output），切换到对应插件通道（如 Python 或 Volar），看是否有 spawn ENOENT 或 Failed to fetch。
Vue 项目离线启用代码提示和坏味道检测，Volar 是唯一可行路径
Vetur 已过时且与 Vue 3 组合式 API 冲突，离线环境下必须用 Volar，但它不像普通插件那样“装完即用”：
- 必须同时安装两个扩展：
Vue Language Features (Volar)和TypeScript Vue Plugin (Volar) - 项目根目录下必须存在
tsconfig.json或jsconfig.json（哪怕空文件），否则 Volar 不启动 TS 支持 - 设置中禁用 Vetur：
"vetur.validation.script": false、"vetur.validation.template": false - ESLint 检测坏味道需显式配置：
"eslint.probe": ["javascript", "typescript", "vue"]，否则<script setup></script>块不被扫描
真正能识别 v-if 套 v-for、响应式依赖漏写、重复 computed 的工具只有 SonarLint，但它在离线环境里需要提前在有网机器上完成规则缓存和二进制下载——这点几乎没人做，所以多数内网 Vue 项目其实只实现了基础语法提示，深层坏味道仍靠人工 review。
