VSCode不存在官方离线文档插件，所谓“离线文档”实为语言服务器内置提示、插件自带静态HTML或用户配置本地文档路径三类机制；Python/TS/C++等语言离线后文档失效，因LSP依赖远程类型库与文档源；可行方案仅有预置typeshed/@types/SDK包或本地HTTP服务模拟文档源。
VSCode离线文档插件根本不存在
VSCode 没有官方提供的「离线文档插件」。所谓“离线文档”，实际是三类不同机制的组合：语言服务器内置文档（如 pyright 的 hover 提示）、插件自带的静态 HTML 文档（极少见）、或用户手动配置的本地文档根路径（如 html.suggest.html5 关联本地 MDN ZIP）。试图搜索 “vscode offline documentation extension” 会导向一堆失效链接或伪装成文档插件的广告包。
Python/JavaScript 等语言的文档提示为什么离线后失效
现象是：鼠标悬停不显示函数说明，Ctrl+Space 补全没参数注释，F12 跳转定义后点进源码也看不到 docstring —— 这不是插件没装好，而是语言服务（LSP）本身没带文档数据，且默认依赖在线抓取（如 TypeScript Server 会查 https://github.com/microsoft/TypeScript，Pyright 会查 typeshed 的远程分支）。
- Python：
ms-python.python插件只提供接口，真正返回文档的是pyright；离线时若未预装typeshed快照，hover 就是空的 - TypeScript：
typescript-language-features是 VSCode 内置，但它的类型库和文档映射依赖tsserver启动时加载的lib.d.ts和@types包，这些必须随 Node 模块一并离线部署 - C/C++：
cpptools的文档提示来自clangd或其自研 server，但头文件注释（如stdio.h）需本地存在完整工具链 + SDK 路径才能解析
真正能落地的离线文档方案只有两种
别折腾“文档插件”，直接控制数据源头：
-
方案一：预置 typeshed / @types / SDK 文档包
例如 Python 场景：下载 typeshed 最新 release ZIP，解压到~/.vscode/extensions/ms-python.python-2024.6.0/dist/typeshed（路径以你安装的.vsix解压结构为准）；再在settings.json中加："python.typeChecking.pyright.typeshedPath": "${env:HOME}/.vscode/extensions/ms-python.python-2024.6.0/dist/typeshed" -
方案二：用本地 HTTP 服务模拟文档源
把 MDN、Dash、或 Doxygen 生成的文档放在本地目录（如D:\docs\mdn-html），启动一个免依赖的静态服务：python -m http.server 8000 --directory D:\docs\mdn-html
然后在插件设置里把文档 URL 改成http://localhost:8000（部分插件支持，如bradlc.vscode-tailwindcss的tailwindCSS.includeLanguages配合自定义 CSS 文档）
别信“一键离线文档包”压缩包
网上流传的 vscode-offline-docs-2024.zip 类资源，99% 是以下三种之一：
— 把 VSCode 官方 product.json 里 documentationUrl 字段硬替换成 file:/// 协议（VSCode 不认）
— 打包了旧版 vscode-icons 或 markdown-preview-enhanced，跟文档无关
— 压缩了已过期的 Dash DOCSET（需额外安装 Dash.app，且 VSCode 无法直接调用）
这类包放进 extensions/ 目录只会触发签名验证失败或静默忽略——code --install-extension 根本不会识别它为合法扩展。
