离线文档插件装了不显示，根本原因是文档后端缺失——插件默认依赖在线 schema 或 docs api，离线时静默降级，悬停、跳转、f1 帮助全失效；需手动对接 zeal 离线文档或本地 schema 并显式配置路径。
离线文档在 VSCode 里不是“装个插件就自动有”，而是必须手动把文档数据源（通常是本地 HTTP 服务或静态文件）对接到支持该协议的插件，否则 Ctrl+Click 跳转、悬停提示、F1 查帮助全是空的。
为什么离线文档插件装了也不显示？
常见现象是：装了 redhat.vscode-yaml 或 ms-python.python，悬停没提示；点进函数定义是空白页；按 F1 搜 “python list” 无结果。根本原因不是插件没装，而是文档后端缺失——这些插件默认依赖在线 Schema 或官方 Docs API，离线时连接超时，直接静默降级为无文档。
-
redhat.vscode-yaml会尝试拉取https://json.schemastore.org/yaml，失败后不报错，但校验和悬停全失效 -
ms-python.python的 Pylance 引擎需要python-docs数据包，离线时无法下载，导致str.split()这类基础方法无悬停说明 - VSCode 自带的
html/css文档提示走的是内置 help bundle，但仅限基础语法，不包含 MDN 最新属性说明
用 Zeal 离线文档 + Dash 插件桥接
Zeal 是最成熟的离线文档浏览器，支持从 docs.rs、devdocs.io、MDN 等渠道一键下载整套文档集（含 Python、Vue、React、C++ STL 等），而 dbaeumer.vscode-dash 插件能把它变成 VSCode 的原生文档源。
- 在外网机器上安装 Zeal（Windows/macOS/Linux 均有便携版），打开后添加所需文档集（如
Python 3、Vue.js、MDN Web Docs） - Zeal 默认存文档到：
%LOCALAPPDATA%ZealDocsets（Win）或~/Library/Application Support/Zeal/Docsets（macOS）或~/.local/share/zeal/docsets（Linux） - 把整个
Docsets文件夹拷到离线机相同路径下 - 在离线机安装
dbaeumer.vscode-dash（注意核对engines.vscode兼容性） - 在
settings.json中配置："dash.docsetPath": "~/.local/share/zeal/docsets"
（Linux/macOS）或"dash.docsetPath": "%LOCALAPPDATA%\Zeal\Docsets"
（Windows）
Python 场景：Pylance 离线文档补丁
即使装了 Zeal，ms-python.python 的 Pylance 仍不会自动读它。必须强制指定 Python 文档路径，否则 list.append() 悬停还是空。
- 确认已安装
python-docsdocset（Zeal 里搜 “Python 3” 即可） - 在项目根目录
.vscode/settings.json中加："python.languageServer": "Pylance",<br>"python.analysis.extraPaths": ["."],<br>"python.analysis.typeCheckingMode": "basic"
- 最关键一步：在 VSCode 设置里搜索
python doc，找到Python › Analysis: Docstring Format，设为google（否则部分 docstring 不解析） - 重启 Pylance：命令面板输入
Python: Restart Language Server
Vue/TypeScript 场景：禁用远程 Schema 加载
像 volar 或 vue-language-features 插件默认会请求 https://json.schemastore.org/vue，离线时卡住初始化，连基本语法高亮都延迟。
- 在
settings.json中显式关闭远程加载："volar.trace.server": "off",<br>"volar.server.runtime": "node",<br>"volar.server.pluginPaths": []
- 手动提供本地 Schema：下载
vue-schema.json（可从 schemastore.org 离线抓取），然后配置："html.suggest.html5": true,<br>"html.validate.scripts": false,<br>"html.schemas": [<br> { "fileMatch": ["*.vue"], "url": "./schemas/vue-schema.json" }<br>] - 确保
vue-schema.json放在工作区根目录或.vscode/schemas/下
真正麻烦的从来不是“找不到文档”，而是插件在离线时悄悄退化成哑巴——不报错、不提示、不 fallback。所有文档路径必须用绝对路径或工作区相对路径显式声明，任何依赖环境变量自动推导的配置（比如 ${env:HOME} 在 Windows 上可能为空）都会让悬停彻底失效。
