离线安装VSCode插件的关键在于绕过签名验证、补全依赖及预置LSP服务：拖拽.vsix至编辑区最可靠；CLI安装须加--allow-unverified；语言插件需提前下载LSP或使用含二进制的完整版.vsix；依赖插件须手动安装；禁用组策略时可解压直投extensions目录并彻底重启。
离线安装 VSCode 插件本身不难，难的是装完“看似成功”却根本用不了——比如 Python 插件卡在 Downloading、Prettier 按格式化没反应、或者扩展面板显示已启用但命令面板搜不到任何指令。核心问题不在安装动作，而在签名验证、依赖初始化、LSP 服务加载这三个环节被静默跳过或失败。
拖拽 .vsix 到编辑区是最稳的安装方式
VSCode 已启动、加载了任意工作区（哪怕只是空文件夹）、窗口有焦点、未全屏、未处于远程连接状态时，把未解压的 .vsix 文件直接拖进主编辑区域（不是侧边栏、不是设置页），松手就会弹出安装确认框。这是唯一不触发任何网络请求、不依赖 CLI、成功率最高的方式。
- 如果拖进去没反应，先看右下角状态栏是否显示
Extensions disabled by policy：企业组策略可能已全局禁用扩展安装 - 安装后插件默认是禁用状态，必须手动点「启用」，或完全退出 VSCode 再重启
- 语言类插件（如
ms-python.python）首次启用会尝试下载 LSP 服务，离线时会卡在Downloading—— 这不是安装失败，而是后续初始化卡住，需提前准备带 LSP 二进制的完整版.vsix或手动补全
code --install-extension 命令必须加 --allow-unverified
离线环境下 code --install-extension 报 INVALID_SIGNATURE 是最常见错误，本质是 VSCode 无法校验微软证书链，不是文件损坏，也不是路径错。
- 必须加
--allow-unverified参数：code --install-extension python.vsix --allow-unverified -
code命令不可用？不是 PATH 问题，而是 VSCode 从未启用 Shell Command：按Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车执行 - Windows 下路径含空格或中文会静默失败，务必移到纯英文路径，例如
C:/vsix/python.vsix，并用双引号包裹：code --install-extension "C:/vsix/python.vsix" --allow-unverified
装完不生效？重点查依赖和 LSP 初始化
扩展面板显示“已安装”不等于可用。Python 插件依赖 ms-python.pylance，Tailwind CSS 插件依赖 bradlc.vscode-tailwindcss，这些不会自动装，也不会报错，只会让功能残缺。
- 真实依赖藏在
.vsix解压后的package.json的extensionDependencies字段里，不是插件页面写的 “Recommended” - 语言插件首次启用时若无网，会卡在
Downloading language server—— 必须提前在联网机器上打开该插件一次，等 LSP 下载完成，再整目录打包迁移；或下载带内置二进制的完整版.vsix（通常体积更大，文件名含win32-x64/darwin-arm64等平台标识） - 验证是否真能用：按
Ctrl+Shift+P→ 输入Developer: Show Running Extensions，看目标插件状态是否为activated，而不是starting或空白
手动解压 .vsix 到 extensions 目录是绕过策略封锁的应急方案
当 GUI 和 CLI 都被组策略禁用，或需要部署含 native 二进制（如 pyright、esbuild）的插件时，只能拆包直装——但这不是简单复制粘贴，而是严格还原目录结构。
- 解压
.vsix后，顶层目录名必须是扩展ID-版本号格式（如ms-python.python-2024.6.0），不能改名 - 整个解压后的文件夹（含
node_modules等）移入对应extensions路径：
Windows：%USERPROFILE%\.vscode\extensions\
macOS/Linux：$HOME/.vscode/extensions/ - 复制完必须完全退出 VSCode（包括系统托盘进程），再重新打开，否则不会加载
最容易被忽略的是：离线装插件不是“一步到位”，而是一连串依赖链的还原。你看到的只是一个 .vsix 文件，但它背后可能牵扯三个签名验证、两个语言服务器、四个隐式依赖插件。别只盯着安装动作，要盯住“第一次启用时发生了什么”。
