VSCode离线文档怎么在内网环境打开-VSCode-PHP中文网

vs code离线文档功能失效主因是语言服务运行时依赖的元数据源缺失，而非vs code本体缺文档；需在内网提前下载并配置pyright/typeshed、typescript/lib、clangd等静态资源，并确保pylance等插件已部署到远端vscode-server/extensions目录。

vscode离线文档怎么在内网环境打开

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 本体，也不需要外网代理。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

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，没输出就说明插件没生效。