VSCode 本身不自带离线文档系统，所谓“离线文档集成”实为将官方 HTML/Markdown 文档本地化部署，并通过插件（如 vscode-html-preview）或手动配置在编辑器内访问；需下载对应 .vsix 插件、配置白名单路径、解压文档至工作区并用预览功能打开，无法统一搜索或一键调用。
VSCode 本身不自带离线文档系统，所谓“离线文档集成”，实际是指把语言、框架或工具的官方文档（HTML 或 Markdown 格式）本地化部署，并通过插件或手动方式在编辑器内快速访问。它不是 VSCode 功能，而是靠外部资源 + 配置达成的体验。
vscode 中如何打开本地 HTML 文档
最直接的方式是用内置的 Open in Default Browser 命令，但这样会跳出编辑器。更符合开发流的是用 vscode-html-preview 这类轻量插件——它不联网、无依赖，双击 HTML 文件就能在编辑器右侧预览。
- 安装方式：离线时必须用
.vsix文件，搜索 “html preview” 找到官方维护的版本（如georgewfraser.vscode-html-preview），下载对应 VSCode 版本的.vsix后拖入窗口安装 - 注意路径权限：VSCode 默认禁止跨目录加载本地文件，若文档放在
/usr/local/docs这类非工作区路径，需在设置中加白名单："html.preview.enablePreviewSecurity": false（仅限可信本地环境） - 快捷键绑定：可自定义
Ctrl+Shift+P→HTML: Open Preview to the Side绑定到常用键位，避免每次右键
Python/TypeScript 等语言文档怎么离线接入
这类文档通常以 docs.zip 或 html/ 目录形式存在（如 Python 官网提供的 python-3.12-docs-html.tar.bz2）。接入关键不是“装进 VSCode”，而是让已有的语言服务能识别本地路径。
- Python：在
settings.json中配"python.defaultInterpreterPath"没用；真正起效的是"python.sphinxBuildPath"或配合docsmsft.python插件的"python.docstringUrl"，但后者只支持在线 URL。稳妥做法是解压文档到项目根目录下./docs/python/，然后用上面提到的 HTML Preview 插件手动打开index.html - TypeScript：TS 自带
tsserver不读外部文档，但你可以把 TypeScript Handbook 的离线版（GitHub 上有microsoft/TypeScript-Handbook的静态站点导出）放在工作区，用Ctrl+Click跳转到本地./handbook/interfaces.html—— 这需要你在代码注释里写明确的相对路径链接 - Vue/React：它们的 CLI 工具（如
vue-cli-service docs:build）能生成离线 HTML，生成后直接用 HTML Preview 打开即可，无需额外配置
为什么不能像 IDE 那样按 F1 直接查离线 API
因为 VSCode 的 Ctrl+Space / F1 补全和帮助，依赖的是语言服务器（LSP）返回的 documentation 字段，而这个字段内容由服务器决定。绝大多数 LSP 实现（如 pyright、typescript-language-server）默认不嵌入完整文档，只返回签名和简短说明。
- 例外情况：某些插件如
docsmsft.powershell会在本地缓存 PowerShell cmdlet 的帮助文本，但这是特例，不是通用机制 - 变通方案：用
markdown-pdf插件把官方 Markdown 文档转成 PDF，再用 VSCode 内置 PDF 预览打开——比 HTML 更稳定，不依赖 JS 渲染 - 根本限制：VSCode 没有“全局离线文档索引”模块，所有文档访问都是文件级或插件级的，无法统一注册、搜索或跳转
真正难的不是“怎么放进去”，而是“怎么让不同语言、不同来源的文档在同一个快捷键下响应”。目前没有通用解法，每个技术栈都得单独配路径、插件和快捷方式。别指望一键集成，重点是把常用文档解压到固定位置，再用一个轻量插件保持打开状态——这才是内网开发中最可持续的做法。
