vscode无官方离线文档包,但内置帮助(快捷键、设置等)已随安装包内嵌,可离线使用;插件文档需手动缓存github readme或市场页html,部分插件(如vscode-yaml)hover提示离线可用,而依赖cdn的插件断网后失效。

VSCode 没有官方提供的“离线文档包”下载渠道,所谓“离线文档”实际指两件事:一是 VSCode 自身的内置帮助(如快捷键、命令面板提示、设置项说明),二是扩展插件附带的文档(如 Markdown 预览、Language Server 的 hover 提示、代码补全说明)。这两类内容都无法单独打包下载,但可以本地化缓存或替代使用。
VSCode 内置帮助根本不需要下载
所有快捷键、命令、设置项描述、键盘布局说明等,都已随 VSCode 二进制文件一并安装。打开 Ctrl+Shift+P 输入 Help: Toggle Developer Tools 后,在控制台执行 require('vs/platform/environment/node/environment').isBuilt 返回 true,就说明你用的是正式版——这些文本资源全部内嵌在 resources/app/out 下的 JSON 和 HTML 文件中,启动即可用,不依赖网络。
常见误解是看到 Help → Keyboard Shortcuts Reference 打开的是网页,其实那只是个本地 file:// 协议链接,对应路径类似:file:///Applications/Visual%20Studio%20Code.app/Contents/Resources/app/out/vs/workbench/contrib/help/browser/shortcuts.html(macOS)或 C:\Users\{user}\AppData\Local\Programs\Microsoft VS Code\resources\app\out\vs\workbench\contrib\help\browser\shortcuts.html(Windows)。直接复制该 URL 到浏览器地址栏就能离线查看。
插件文档无法批量导出,但可本地缓存
多数插件(如 ms-python.python、esbenp.prettier-vscode)的文档以 Markdown 形式放在仓库 README.md 或 package.json 的 description/homepage 字段中。VSCode 不会自动下载这些内容,只有在鼠标悬停、按 F1 查命令、或点击插件详情页时,才通过 https 加载远程链接——这就是你“没网就看不到说明”的原因。
可行做法是:
- 对关键插件,手动访问其 GitHub/GitLab 仓库,下载
README.md和docs/目录,存为本地知识库 - 用浏览器插件(如 SingleFile)保存插件市场页(
https://marketplace.visualstudio.com/items?itemName=xxx.yyy)为完整 HTML,含截图和版本说明 - 某些插件(如
redhat.vscode-yaml)自带language-features,hover 提示文本来自插件自身代码,只要插件已安装,这部分就是离线可用的
code --list-extensions --show-versions 能帮你确认哪些插件自带文档逻辑
运行该命令后,观察输出里是否含 ms-vscode.vscode-typescript-next 这类带 typescript 或 language-features 关键词的扩展名。这类插件通常把语言服务文档内嵌在 node_modules 或 dist 目录下,而非调用外部链接。而像 bradlc.vscode-tailwindcss 这种重度依赖在线 CDN 加载配置说明的插件,离线时 hover 就只剩空框。
验证方法:断网 → 打开一个 .ts 文件 → 把光标停在 interface 上 → 看是否有定义弹出。有,说明文档逻辑已加载;无,大概率依赖网络。
真正需要警惕的不是“文档下不了”,而是插件首次启用时静默拉取远程 schema 或 grammar(比如 GraphQL 插件会尝试连 https://spec.graphql.org/)。这种行为不会报错,但会导致 hover 和 validation 失效——得提前在有网环境触发一次完整加载,再拷走整个 ~/.vscode/extensions/{ext-id} 文件夹,而不是只拷 .vsix。











