离线安装vscode插件本身可行且官方支持，难点在于找对版本和绕过策略拦截；必须用官方市场原始url或api拼直链下载.vsix，严格匹配vscode版本、架构及签名要求，并注意路径、焦点、依赖等细节。
直接说结论：离线安装本身不难，难在「找对版本」和「绕过策略拦截」。VSCode 官方完全支持 .vsix 安装，但公司网络封掉 marketplace.visualstudio.com 后，人工拼下载链接、核对兼容性、处理路径空格、应对组策略禁用——这些环节一环出错，整个流程就卡住。
怎么从 Marketplace 拿到真正能用的 .vsix 直链
别点“Download Extension”按钮就完事。这个按钮在缓存页或镜像站上可能跳转到 HTML 错误页，或者返回旧版 .vsix；更常见的是，它给的版本和你本地 VSCode 不兼容。
- 必须用官方市场原始 URL，例如
https://marketplace.visualstudio.com/items?itemName=ms-python.python，打开后右侧 Resources 区域的 Download Extension 才可靠 - 如果需要批量或精准控制，用官方 API 拼直链：
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension_name}/{version}/vspackage，其中{publisher}是 ID 前半段（如ms-python），{extension_name}是后半段（如python），{version}必须和你 VSCode 的engines.vscode要求匹配（查code --version和插件详情页 Requirements 栏） - Windows 用户注意加
?targetPlatform=win32-x64参数，Linux/macOS 加linux-x64或darwin-arm64，否则下载回来的包可能架构不匹配
code --install-extension 命令为什么总失败
报错信息往往只有一行，但根源就那几个：
-
command not found: code→ 不是没装 VSCode，而是 Shell Command 没注册：在 VSCode 里按Ctrl+Shift+P，输入Shell Command: Install 'code' command in PATH并执行 -
ENOENT: no such file→ 路径写错，Windows 下含空格必须用双引号包裹：code --install-extension "D:\my exts\python-2024.6.0.vsix" -
INVALID_SIGNATURE→ 离线环境无法校验证书链，加--allow-unverified参数即可：code --install-extension python.vsix --allow-unverified - 静默无反应 → 先确认 VSCode 进程是否完全退出（包括托盘图标），再重试；若仍不行，说明组策略已禁用扩展安装，右下角状态栏会显示
Extensions disabled by policy
拖拽 .vsix 到编辑区为什么没反应
这是成功率最高的方式，但触发条件很具体：
- VSCode 必须已启动，且窗口有焦点（不能最小化、不能全屏、不能处于远程连接状态）
- 必须拖进主编辑区域（即中间代码显示区），不是侧边栏、不是设置页、不是终端面板
- 拖入的文件必须是未解压的原始
.vsix，不能是 zip 解压后重命名的文件 - 如果仍无反应，先检查右下角状态栏是否提示
Extensions disabled by policy；有则说明企业组策略已全局封锁，只能走手动解压方案
手动解压 .vsix 是最后手段，但结构不能错
当 GUI 和 CLI 都被禁用，或插件含 native 二进制（如 pyright、esbuild），就得拆包直装：
- 用 7-Zip 或系统自带解压工具打开
.vsix，顶层目录名必须是{publisher}.{extension_name}-{version}格式（如ms-python.python-2024.6.0），不能改名 - 把整个解压后的文件夹（含
node_modules、package.json等）复制到对应 extensions 目录：
Windows：%USERPROFILE%\.vscode\extensions\
macOS/Linux：$HOME/.vscode/extensions/ - 复制完必须彻底退出 VSCode（任务管理器里杀掉所有
Code.exe或Code Helper进程），再重新打开，否则不会加载 - 验证不能只看扩展面板是否显示“已安装”，要打开 Developer: Show Running Extensions，确认进程真实运行；Python 类插件还要检查右下角是否提示 Pylance 已加载
最容易被忽略的一点：插件依赖不会自动带进来。比如装了 ms-python.python，但没装 ms-python.pylance，Python 功能就残缺。真正的离线部署，得先在联网机器上跑 code --list-extensions > extensions.txt，再逐个下载，或者解析每个 .vsix 里的 package.json 中的 extensionDependencies 字段。
