离线服务器无法访问vscode官方文档网站，需下载微软官方pdf文档包并用vscode-pdfviewer插件离线查看；须手动配置文件关联为"*.pdf": "pdf-preview"，检查状态栏显示pdf preview，大文件可调低maxrenderedpagecount防卡顿。
离线服务器上根本打不开官方文档网站
VSCode 官方文档（code.visualstudio.com/docs）在断网服务器上完全不可达，这不是配置问题，是物理隔离。你 SSH 进去后用 curl https://code.visualstudio.com/docs 会直接超时，浏览器也打不开。这时候指望在线帮助面板（Ctrl+Shift+P → “Help: Open Documentation”）毫无意义——它底层就是跳转到那个域名。
PDF 文档预览器 + 离线 PDF 包才是可行路径
VSCode 自身不带本地文档，但你可以把官方文档导出为 PDF 后，用 vscode-pdfviewer 插件离线查看。关键点在于：PDF 必须是完整、结构化、带书签的版本，不能是随便网页打印出来的碎片。
- 在有网机器上访问
https://code.visualstudio.com/docs，用浏览器「另存为」PDF 通常失败——目录丢失、链接失效、样式错乱 - 可靠做法是下载微软官方发布的 PDF 文档包：它们定期发布在 GitHub release 页面，例如搜索
vscode-docs-pdf或访问https://github.com/microsoft/vscode-docs/releases（需提前下载好vscode-docs-2026-09.pdf这类文件） - 传到离线服务器后，确保已安装
vscode-pdfviewer插件（用code --install-extension tomoki1207.pdf-preview-1.12.0.vsix离线安装），然后直接双击 PDF 文件即可打开
别忽略 PDF 预览器的默认行为陷阱
vscode-pdfviewer 默认不会自动启用 PDF 关联，即使插件装好了，双击 PDF 可能还是用系统默认阅读器打开，或者弹出“无法预览”的提示。
- 必须手动设置文件关联：在 VSCode 设置里搜
files.associations，加一条"*.pdf": "pdf-preview" - 检查右下角状态栏是否显示
PDF Preview—— 如果显示的是Plain Text或空白，说明文件没被正确识别 - 首次打开大 PDF（>50MB）可能卡住几秒，不要误判为崩溃；可先在设置里调低
pdf-preview.maxRenderedPageCount避免内存溢出
扩展自带文档基本不可信
很多扩展声称“支持离线文档”，比如某些语言插件会在 node_modules 里放 README.md，但这些只是简易说明，不是 VSCode 自身功能文档。更危险的是：部分插件的“帮助”按钮会硬编码跳转到 market URL，离线时点击直接报 ERR_CONNECTION_REFUSED，且无 fallback。
真正能离线查的只有三类内容：PDF 文档包、VSCode 内置快捷键提示（Ctrl+K Ctrl+I 对当前语法有效，但仅限符号 hover）、以及你本地保存的 settings.json 注释片段。其他一切依赖网络的“文档入口”，在断网服务器上都只是摆设。
