vscode离线时插件文档不显示，因扩展面板依赖联网加载市场元数据且不缓存readme.md；可靠方法是解压vsix直读extension/readme.md或从github下载，而运行时lsp服务、二进制依赖等才是离线生效的关键。
VSCode离线环境下插件文档根本不会自动导入
VSCode 本身不提供“插件文档离线包”这个概念，vsix 文件里只含代码、图标、package.json 和 README.md（如果作者提交了），但这些文档默认**不会在离线时显示在扩展面板里**——你点开已安装插件的详情页，看到的是空白或“无法加载描述”的提示。
为什么离线后插件页面看不到 README 或功能说明
这是因为 VSCode 扩展视图的文档渲染依赖两个条件：
- 插件包内必须包含
README.md（不是所有作者都放） - VSCode 需要能访问
marketplace.visualstudio.com来补全市场页元数据（如评分、更新日志、截图），这部分在离线时直接 fallback 为空
即使你手动下载了带 README.md 的 .vsix，VSCode 也只在首次安装时解析一次，且不缓存到 UI 层；后续打开扩展面板，它仍会尝试联网拉取富文本渲染所需资源，失败即留白。
怎么让离线机器也能看到插件原始文档
唯一可靠方式是绕过 UI，直读文件。操作步骤如下：
- 用
unzip -p your-extension.vsix extension/README.md（Linux/macOS）或 7-Zip 打开.vsix查看顶层extension/目录下是否存在README.md - 若存在，解压整个
.vsix（unzip your-extension.vsix -d ./readme-src），然后用任意 Markdown 查看器打开./readme-src/extension/README.md - 若不存在，去插件 GitHub 仓库（如
https://github.com/microsoft/vscode-python）找对应 tag 分支下的README.md，提前下载保存 - 想集中管理？把所有插件的
README.md拷进一个本地目录，用 VSCode 打开该目录，直接点击文件预览 —— 这比等扩展面板加载更稳
别指望“导入文档”能解决实际使用问题
真正卡住你的从来不是“看不到说明”，而是：ms-python.python 离线后不启动 pyright-server、volarjs.volar 找不到 @vue/language-core、esbenp.prettier-vscode 报 spawn ENOENT……这些错误在文档里找不到答案，因为它们发生在运行时，和 README.md 无关。文档只是入口，LSP 二进制、类型定义、工作区配置，才是离线生效的硬门槛。
