内网离线装vscode扩展失败主因是vsix版本不匹配、签名校验失败或lsp服务未离线部署；须手动比对engines.vscode与本地版本、加--allow-unverified参数安装、并在有网机预触发并迁移完整lsp二进制及依赖插件。
内网离线装 VSCode 扩展，失败主因不是文件没拷对，而是 vsix 拿错了版本、签名校验卡住、或 LSP 服务根本没落地——装上≠能用。
怎么拼出正确的 vsix 下载链接
市场页面点「Download Extension」看似直接，但内网机器的 VSCode 版本往往老旧（比如 1.78.2），而官网默认给的是最新版 ms-python.python-2024.12.0.vsix，一装就报 Extensions compatibility is not supported。
- 别信页面上“Latest release”字样，要去
https://marketplace.visualstudio.com/items/ms-python.python/versionhistory手动翻历史版本，找engines.vscode字段 ≤ 你本地 VSCode 版本的条目 - 更稳的方式是用直链模板：把 Marketplace 页面 URL 中的
/item?itemName=ms-python.python替成/item/vsix?itemName=ms-python.python&version=2023.10.1，再补上&targetPlatform=win32-x64（根据内网系统选） - 如果用
vsce download，必须加--version参数，否则默认拉最新：vsce download ms-python.python --version 2023.10.1 > python.vsix
命令行安装静默失败的三个硬坑
code --install-extension 看似干净，但不报错 ≠ 装上了。常见现象是执行完列表里没有、重启也没用。
- 路径必须是绝对路径，且含英文双引号（尤其有空格或中文时）：
code --install-extension "/mnt/共享盘/python-2023.10.1.vsix" - 离线环境无法走 HTTPS 校验证书链，必须加
--allow-unverified，否则静默跳过：code --install-extension python.vsix --allow-unverified - VSCode 进程没彻底退出——右下角托盘图标右键「退出」，否则插件缓存不刷新，重装也白搭
拖拽安装没反应？不是文件问题，是窗口状态不对
很多人反复拖 .vsix 到 VSCode 窗口，毫无反应，第一反应是文件坏了。其实它只在三种条件下响应拖放事件：
- VSCode 必须已加载一个工作区（哪怕只是空文件夹），纯启动页或远程连接未建立时，拖放被忽略
- 窗口必须有系统焦点（任务栏高亮），不能处于全屏、RDP、TeamViewer 或多显示器缩放偏移状态
- 拖的是原始
.vsix文件，不是python.vsix.zip（Windows 双后缀会静默解压）、不是解压后的文件夹、也不是 GitHub clone 的源码目录
装上了却没语法高亮？LSP 服务没离线部署
像 ms-python.python、rust-lang.rust-analyzer 这类插件，.vsix 只是前端壳，首次启用时会联网下载语言服务器二进制（如 pyright-server）。内网环境下，它就卡在「Downloading…」或直接跳过。
- 必须手动补全 server：查插件文档确认 LSP 名称和版本，去对应 GitHub Release 下载
server二进制（如pyright-1.1.350-win32-x64.zip），解压后放进~/.vscode/extensions/ms-python.python-2023.10.1/dist/server/ - 依赖插件也要一并离线装，比如
ms-python.python依赖ms-python.vscode-pylance，两个.vsix都得拷过去 - 验证是否生效：
Ctrl+Shift+P→ 输入Developer: Toggle Developer Tools，切到 Console，打开 Python 文件，看有没有Starting language server日志
最常被跳过的环节是 LSP 二进制补全——装完插件看到名字在列表里，就以为搞定了。实际上没 server，打开 .py 文件就是纯文本，连括号匹配都可能失效。
