拖拽.vsix到主编辑区是最稳的离线安装方式；需vscode已启动并聚焦、非欢迎页、非远程状态，且outline功能依赖语言服务器，离线时须手动迁移完整扩展目录或解压至extensions路径。
拖拽 .vsix 到主编辑区是最稳的安装方式
VSCode 离线装插件，Outline 类插件（比如 docsmsft.vscode-docs、rust-lang.rust-analyzer、oderwat.indent-rainbow 的结构辅助功能）本身不自带大纲视图，真正提供代码结构大纲的是语言服务器或专用插件，如 ms-python.python（配合 pyright）、rust-lang.rust-analyzer 或通用型 alefragnani.project-manager 配合自定义 outline provider。但无论哪一类，只要它以 .vsix 形式分发，拖拽安装就是成功率最高、不触发网络请求的方式。
前提是：VSCode 已启动并加载了任意工作区（哪怕只是空文件夹），窗口有焦点（任务栏图标高亮），未全屏，且未处于远程连接（SSH/Dev Containers）状态。把未解压的 xxx.vsix 文件直接拖进中间白色编辑区（不是侧边栏、不是扩展面板、不是设置页），松手就会弹出确认框。
常见静默失败原因：
- 拖进了扩展面板（Extensions view）——它只响应“Install from VSIX”命令，不响应拖放
- VSCode 处于欢迎页（Welcome Page）——必须先打开一个文件夹或文件
- 右下角状态栏显示
Extensions disabled by policy——企业组策略已禁用，拖拽和命令行都会失效
code --install-extension 命令必须用绝对路径且校验版本
批量部署或脚本化时常用 code --install-extension，但它对路径和版本极其敏感。报错 not compatible with Code 几乎全是版本不匹配导致，和网络无关。
实操要点：
- Windows 下路径含空格必须加双引号：
code --install-extension "C:\ext\rust-lang.rust-analyzer-0.84.2126.vsix" - Linux/macOS 必须用绝对路径：
code --install-extension /opt/vscode-ext/rust-lang.rust-analyzer-0.84.2126.vsix - 若提示
command not found: code，说明 CLI 未注册：按Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH并执行 - 运行
code --version，取前两位（如1.85.2→1.85）；再用unzip -p xxx.vsix extension/package.json | grep engines查插件要求的"vscode": "^1.80.0"——你本地版本必须 ≥ 要求的最低版本
Outline 功能不生效？大概率缺语言服务器二进制
很多插件（如 ms-python.python、rust-lang.rust-analyzer、volarjs.volar）安装后只注册前端逻辑，真正的代码结构解析靠后台 native 服务（pyright、rust-analyzer、volar-server）。离线时这些服务不会自动下载，结果就是大纲视图空白、状态栏卡在 Downloading...、Output 面板报 spawn ENOENT。
正确做法不是重装 .vsix，而是迁移完整扩展目录：
- 在一台能联网、VSCode 版本和架构（x64/arm64）一致的机器上，安装对应
.vsix，然后打开一个.py/.rs/.vue文件，等状态栏显示绿色就绪（如Rust Analyzer: Ready） - 退出 VSCode，拷贝整个扩展文件夹（如
~/.vscode/extensions/rust-lang.rust-analyzer-0.84.2126/）到内网机相同路径 - 确保目标机完全退出 VSCode（包括托盘进程），再重启——否则不会加载新目录
- 验证：打开对应文件，看
Outline视图是否列出函数/模块/类，而非一直显示Loading...
手动解压直投 extensions 目录是最后手段
当拖拽和 CLI 都被组策略封死，或插件含 native 二进制（如 pyright、esbuild）必须补全时，只能手动解压 .vsix 并还原目录结构。
关键细节：
- 用
unzip xxx.vsix -d unpacked/解压，检查顶层是否为extension/目录，且含extension/package.json - 解压后文件夹名必须是
发布者.插件名-版本号格式（如rust-lang.rust-analyzer-0.84.2126），不能改名 - 整个文件夹（含
node_modules、server/、out/）移入：
Windows：%USERPROFILE%\.vscode\extensions\
macOS/Linux：$HOME/.vscode/extensions/ - 复制完必须彻底退出 VSCode（任务管理器/活动监视器里杀干净），否则扩展不会加载
最易被忽略的一点：Outline 视图是否可用，不能只看扩展面板里有没有勾选，必须打开真实源码文件、观察 Outline 面板内容是否实时刷新、Output 面板对应通道有无报错。很多“已安装”只是壳，没 server 就等于没结构解析能力。
