离线安装VSIX卡住主因是路径错误、签名校验失败或VSCode未彻底退出；需用绝对路径加引号、加--allow-unverified参数、确保工作区加载及窗口焦点，并补全LSP服务器等离线依赖。
离线安装 VSIX 卡住，基本不是网络问题——而是 VSCode 在某个环节静默放弃，且不报错。最常见原因就三个：路径不对、签名校验失败、VSCode 没真正退出。
code --install-extension 命令没反应？先盯住这三件事
命令行看似最可控，但实际最容易“执行了却像没执行”。它不会提示路径错误，也不会说签名过期，只会沉默。
- 必须用绝对路径：
code --install-extension /home/user/ext/ms-python.python-2024.6.0.vsix（Linux/macOS），或code --install-extension C:/ext/prettier-9.10.3.vsix（Windows，推荐正斜杠） - 路径含空格或中文？加英文双引号：
code --install-extension "/mnt/内网共享/veriloghdl-v1.12.0.vsix" - 离线环境无法校验证书链时，必须加
--allow-unverified参数：code --install-extension python.vsix --allow-unverified
拖拽 .vsix 到窗口没反应？不是文件问题，是环境没就绪
这是最高频的“假失败”，你拖十次，VSCode 一动不动，第一反应是文件坏了——其实它根本没收到拖放信号。
- VSCode 必须已加载一个工作区（哪怕只是空文件夹），纯启动页或远程连接未建立时，拖放事件被忽略
- 窗口要有系统焦点：任务栏图标高亮，且不能处于全屏、RDP、TeamViewer 或多显示器缩放偏移状态
- 拖的是原始
.vsix文件，不是解压后的文件夹、不是.zip、也不是右键重命名生成的prettier.vsix.zip（Windows 会静默解压）
装上了却没功能？LSP 服务根本没落地
很多插件（如 ms-python.python、volarjs.volar、ms-vscode.cpptools）的 .vsix 只是前端壳，真正干活的语言服务器（pyright-server、volar-server、cpptools-srv）得首次启用时联网下载。离线环境下，它就卡在“Downloading…”或直接跳过。
- 正确做法：在有网机器上完整触发一次——打开一个
.py或.vue文件，等状态栏显示 “Ready” 后，再把整个扩展目录（如~/.vscode/extensions/ms-python.python-2024.6.0/）拷到离线机对应路径下 -
ms-vscode.cpptools特别注意：必须手动下载匹配版本的cpptools-srv二进制，放进扩展目录根路径，并确保可执行权限（Linux/macOS 执行chmod +x cpptools-srv） - ARM Mac 装 x64 插件不会报错，只会丢功能；确认
code --version显示架构是arm64，再找带darwin-arm64标识的 vsix
装完提示“Unable to load extension”？断网+关签名校验
手动拖 .vsix 进 VSCode 却弹出这个提示，不是文件损坏，而是 VSCode 仍试图联网校验签名。哪怕你已断网，它也会先发请求，失败后才退到本地加载——而这个流程可能被跳过或中断。
- 最稳做法：拔网线/关 Wi-Fi → 启动 VSCode → 拖
.vsix→ 安装 - 若仍失败，在
settings.json里加一行："extensions.installVerification": false（仅调试用，验证完务必删掉） - 检查
.vsix解压后package.json中engines.vscode字段，比如你 VSCode 是1.90.2，但插件写的是"^1.92.0"，就真不兼容——需解压修改后重新打包
真正麻烦的从来不是“怎么装”，而是“装完之后谁来跑服务”。LSP 二进制、native 依赖、架构匹配、签名绕过——这些细节一旦漏掉一个，VSCode 就只给你一个安静的空白状态栏。
