VS Code离线文档功能失效主因是语言服务运行时依赖的元数据源缺失，而非VS Code本体缺文档；需在内网提前下载并配置pyright/typeshed、typescript/lib、clangd等静态资源，并确保Pylance等插件已部署到远端vscode-server/extensions目录。
VS Code 本身不自带离线文档，所谓“离线文档”实际是指语言服务（如 TypeScript、Python、C++）或扩展（如 Python 官方插件、Pylance、clangd）提供的符号跳转、悬停提示、API 文档摘要等功能。这些功能在内网失效，不是因为 VS Code 没装文档，而是远端 vscode-server 启动后，语言服务器默认会尝试联网抓取官方文档或类型定义（比如 TypeScript 的 @types、Python 的 pylsp 或 pyright 的内置 stubs），或者本地插件试图访问 https://code.visualstudio.com/docs 这类地址。
为什么内网里悬停没文档、F12 跳不到定义
根本原因不是“文档文件没拷进来”，而是语言服务运行时依赖的元数据源缺失。例如：
-
pyright默认启用python.defaultInterpreterPath+python.analysis.extraPaths，但若没配typeshed或本地stub包，悬停里就只有变量名，没有函数签名和 docstring； -
clangd需要提前生成compile_commands.json，且不联网时无法自动 fetch LLVM 官方头文件注释； - TypeScript 的
tsserver会尝试从 npm registry 拉@types/node等包——内网没镜像就返回空定义。
怎么让 Python/TS/C++ 的悬停和跳转在内网可用
核心思路：把语言服务依赖的“静态文档资源”提前下载好，放到远端服务器上，并通过配置指向它们。不需要改 VS Code 本体，也不需要外网代理。
- Python：下载 pyright 离线包（含内置 stubs），解压后设
"python.languageServer": "Pylance"或直接用pyright，再配"python.analysis.typeshedPath"指向解压后的typeshed目录； - TypeScript：在联网机运行
npm install -g typescript，然后把node_modules/typescript/lib整个目录拷进内网服务器，VS Code 远端设置"typescript.tsdk": "/path/to/lib"； - C/C++：用
clangd而非默认 Microsoft C/C++ 扩展（后者会尝试连微软服务器），下载 clangd 二进制，并确保项目根目录有compile_commands.json（用cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON生成）； - 通用技巧：所有语言服务的文档提示都依赖
node_modules或site-packages里的.d.ts/.pyi文件，把这些目录同步过去比“找文档 PDF”有用得多。
VS Code 自身帮助页面（Ctrl+Shift+P → Help: Open Documentation）打不开怎么办
这个命令默认打开 https://code.visualstudio.com/docs，内网必然失败。但 VS Code 的 docs 内容其实是开源的，托管在 github.com/microsoft/vscode-docs。你可以：
- 在联网机器上克隆该仓库：
git clone https://www.php.cn/link/f5d994ce3df227089208ed4137db8688； - 用任意静态站点工具（如
python3 -m http.server 8000）起一个本地服务； - 把整个
vscode-docs目录拷进内网，用浏览器打开index.html即可离线浏览全部官方文档； - 注意：搜索功能依赖 JS，需保留原始 HTML 结构，不要只存 PDF。
最容易被忽略的一点：远端 vscode-server 的插件路径必须包含文档提供者
很多人只在本地装了 Pylance 或 clangd，却忘了这些插件也要部署到远端 ~/.vscode-server/extensions/ 下。Remote-SSH 的语言服务是远端进程驱动的，本地插件只是 UI 层。如果远端 extensions 里没有 ms-python.pylance，哪怕你本地悬停能出文档，F12 也跳不到定义——因为远端 pyright 根本没跑起来。验证方式：连上 Remote-SSH 后，在远端执行 ps aux | grep pyright，没输出就说明插件没生效。
