vscode 官方不提供离线文档包，所谓“离线文档”是用户对插件、语言服务器或网页版文档的误解；真正可批量获取的只有 github 上的开源 markdown 源码（需自行构建）或第三方静态镜像。
VSCode 没有“离线文档”这个官方概念，所谓「离线文档」实际是用户误把插件、语言服务器、帮助页面或官方网页版文档当成可打包下载的本地手册。真正能批量下载的只有插件（.vsix），而 VS Code 自身的文档（如 vscode-docs）是纯静态 HTML/Markdown，不随插件安装自动附带，也不内置于任何 .vsix 中。
为什么搜不到“VSCode离线文档”下载入口
VS Code 官方从未提供一键打包的离线文档包（不像 Python 的 python-docs-html 或 Rust 的 rust-docs）。它的文档托管在 https://www.php.cn/link/97630c351cefa3de62df5cb6f0dbc033，是动态渲染的 Web 页面，含交互式示例、搜索、版本切换等——这些依赖在线服务，无法简单“另存为”。
常见误解来源：
- 把插件自带的
README.md当成文档（它只是简介，不含 API 或教程） - 看到插件启用后弹出的 Quick Start 页面，误以为是“离线帮助”（实为从插件包内读取的静态 HTML，路径如
extension/dist/quickstart.html，但不完整） - 用浏览器“保存网页”只存单页，无导航、无搜索、无版本跳转
能实际批量获取的“文档类内容”只有这些
如果你真需要本地可查、带章节结构、支持离线浏览的资料，目前只有三条可行路径，且都需手动介入：
-
官方 GitHub 文档源码：VS Code 文档全部开源在
https://github.com/microsoft/vscode-docs，用git clone可拉取全部 Markdown 源文件（含docs/下所有章节），但需自行用mdbook或mkdocs构建为可浏览的 HTML 站点 -
插件内置 help 文件：部分插件（如
ms-python.python）在package.json的contributes.configuration或views字段里声明了帮助页路径，解压.vsix后可找到media/help/或out/help/目录，但内容零散、无统一索引 -
第三方镜像站点：如
https://vscode-docs-cn.github.io/（中文社区维护）提供静态 HTML 打包下载，但更新滞后、章节可能不全，且非微软认证
别踩坑：这些操作看似像“下载文档”，实际无效
以下做法在 2026 年已明确不可行或信息过时：
- 运行
code --install-extension安装插件，指望它附带完整文档 —— 插件只含运行时代码和最小化帮助片段 - 用
vsce download抓取插件，再解压找docs/目录 —— 绝大多数插件根本没放文档目录 - 在插件市场页点击 “Download Extension”，以为下载的是“含文档的安装包” —— 下载的只是
.vsix，本质是 ZIP，不含官网 docs 内容 - 用爬虫工具抓
https://www.php.cn/link/97630c351cefa3de62df5cb6f0dbc033/*—— 官网使用 CSR（客户端渲染），直接curl返回空壳 HTML，需 Puppeteer 等执行 JS 才能获取真实内容，且违反robots.txt
真正麻烦的不是“怎么下”，而是“下了之后怎么用”。VS Code 文档的章节之间强依赖跳转（比如「调试 → launch.json → 预设配置」），静态导出后若没构建好内部链接和搜索索引，就只剩一堆孤立 Markdown 文件——看着全，查起来废。建议优先用官方在线文档，离线场景再考虑 vscode-docs 源码 + mdbook serve 本地启动。
