vscode离线安装插件失败主因是联网校验卡住，需确保工作区加载、窗口聚焦、文件完整；命令行安装须用绝对路径、加--allow-unverified绕过签名验证，并彻底退出进程刷新缓存。
局域网环境 ≠ 离线环境，但 VSCode 默认会尝试连外网校验插件签名和依赖，不处理就会卡住或静默失败。关键不是“能不能装”，而是“怎么绕过联网检查、确保功能完整”。
拖拽 .vsix 到 VSCode 没反应？先确认这三件事
这是最常被误判为“插件坏了”的情况，实际是 VSCode 根本没收到安装信号：
- VSCode 必须已加载一个工作区（哪怕只是空文件夹），纯启动页或远程连接未就绪时，拖放事件被直接忽略
- 窗口要有系统焦点：任务栏图标高亮，且不能处于全屏、RDP、TeamViewer 或多显示器缩放偏移状态
- 拖的是原始
.vsix文件，不是解压后的文件夹、.zip、双后缀（如python.vsix.zip）或右键重命名生成的损坏包
验证方法：unzip -l your-extension.vsix 应显示顶层目录为 extension/，且含 extension/package.json；若报错或结构散乱，说明文件已损坏。
code --install-extension 静默失败或报错？盯住路径、签名、进程三处
命令行方式最可控，但容错极低，常见问题集中在：
- 必须用绝对路径：
code --install-extension /home/user/ext/ms-python.python-2024.6.0.vsix（Linux/macOS）；Windows 推荐正斜杠写法：code --install-extension C:/ext/python.vsix - 路径含空格或中文会静默失败，务必移到纯英文路径，且加英文双引号：
code --install-extension "/mnt/vsix/prettier-9.10.3.vsix" - 离线环境无法校验微软证书链，必须加
--allow-unverified参数：code --install-extension python.vsix --allow-unverified - 装完不生效？不是重装，是彻底退出 VSCode——右下角托盘图标也要右键退出，否则缓存不刷新；Windows 下可用任务管理器结束所有
Code.exe进程
插件列表里显示“已安装”，但 Python 补全/格式化不工作？缺 LSP 服务
语言类插件（如 ms-python.python、rust-lang.rust-analyzer）只装 .vsix 是注册前端，真正干活的语言服务器（pyright-server、rust-analyzer）需首次启用时下载。离线环境下它就卡在 “Downloading…” 或静默跳过。
- 正确做法：在有网机器上完整触发一次——打开一个
.py文件 → 等状态栏变绿 → 确认 Output 面板中 Python 通道无报错 → 再拷整个扩展目录 - 路径要完整：
~/.vscode/extensions/ms-python.python-2024.6.0/（Linux/macOS）或%USERPROFILE%\AppData\Roaming\Code\Extensions\ms-python.python-2024.6.0\（Windows） - 复制完必须完全退出 VSCode（包括托盘进程），再重新打开，否则不会加载 native 二进制
批量部署时如何避免版本错配和架构不兼容
企业内网批量装插件，最容易踩的坑是“看着装上了，实则部分功能失效”：
- 比对
code --version输出（如1.85.2→ 取1.85）与.vsix解压后extension/package.json中"engines": {"vscode": "^1.80.0"}字段，版本低于要求会被跳过 - ARM Mac 装 x64 插件不会报错，而是静默丢掉 LSP 功能；运行
code --version看 Help → About 里括号中的架构（arm64/x64），再查.vsix是否含darwin-arm64构建标识 - 从官网下载时，用右侧
Download Extension按钮，别信 GitHub Release 页面或第三方打包站——它们常返回旧版、无签名、或平台不匹配的包
最麻烦的点不在安装动作本身，而在“功能是否真落地”：LSP server、native 二进制、extensionDependencies 依赖项，三者缺一不可，且必须和 VSCode 版本、系统架构严丝合缝。
