vscode离线文档本身不支持跨项目调用，其跨项目文档可用性依赖语言服务器（如pylance、clangd）是否显式配置路径白名单，而非文档扩展本身；默认仅索引当前workspacefolder，需通过python.extrapaths或compile_commands.json等手动声明其他根目录路径并重启服务器。
VSCode 离线文档本身不支持“跨项目调用”——它没有跨根目录自动索引或跳转的机制。所谓“跨项目文档可用”，本质是靠扩展（如 cppreference、Python Docstring Generator 或语言服务器）在本地缓存并响应当前编辑器上下文，而这个上下文是否覆盖多根工作区，取决于扩展自身设计和配置方式。
为什么跨项目文档跳转经常失效
VSCode 的文档提示（悬停、Go to Definition、Peek Documentation）默认只作用于当前激活的 workspaceFolder，即你右键文件时所在的那个根目录。即使你在多根工作区里打开了 ./backend 和 ./frontend，光标在前端文件中按 Ctrl+Click 跳转，不会自动去后端代码里找同名函数或类型定义。
- 语言服务器（如
Pylance、clangd）默认只扫描当前文件夹及其子目录，除非显式配置"python.extraPaths"或compile_commands.json指向其他根目录 -
files.exclude和search.exclude在工作区级设置里生效，但文档索引不读这些规则——它依赖语言服务器自己的路径白名单 - 离线文档扩展（如
cppreference）是纯静态资源，不涉及项目结构，所以“跨项目”对它无意义；真正需要跨项目的是源码级跳转与类型推导
让 Python 项目间能互相查文档和跳转
以 Python 为例，要让 frontend 中的代码能正确解析 backend 里的模块并显示 docstring，关键不是改文档扩展，而是让 Pylance 知道该看哪：
- 在工作区根目录（即
.code-workspace所在目录）建.vscode/settings.json，写入：{ "python.defaultInterpreterPath": "./backend/venv/bin/python", "python.extraPaths": ["./backend/src", "./libs/shared-utils"] } -
extraPaths必须是相对于工作区根的路径，不能用${workspaceFolder:backend}这类变量（Pylance 不识别） - 确保
backend/和shared-utils/下有pyproject.toml或__init__.py，否则 Pylance 不会将其视为可导入包 - 重启 Pylance：命令面板执行
Python: Restart Language Server，不要只重载窗口
Clangd / C++ 项目怎么打通头文件文档
C++ 没有标准的跨项目文档机制，但 clangd 支持通过 compile_commands.json 聚合多个项目的编译信息。如果你的 backend 和 shared-headers 各自生成了 compile_commands.json，就得手动合并：
- 用脚本把两个项目的
compile_commands.json数组拼成一个大数组，保存到工作区根目录 - 在工作区
.vscode/settings.json中指定："clangd.arguments": [ "--compile-commands-dir=.", "--background-index" ]
- 确保所有路径字段（如
file）在合并后仍是相对工作区根的，否则 clangd 加载失败，错误信息是Failed to load compilation database - 不推荐用
-j并行生成多个compile_commands.json再硬链接——clangd 只读一个文件，且不支持 glob
容易被忽略的关键点
多根工作区里，“文档可用性”永远由语言服务器决定，不是由 VSCode 或文档扩展决定。你看到的悬停内容、跳转目标、参数提示，全来自服务器返回的 LSP 响应。而服务器是否知道其他根目录，取决于你有没有在它的配置项里显式声明路径——extraPaths、includePath、compile_commands_dir 这些字段，一个都不能漏，且必须用工作区根为基准写相对路径。一旦写错，它就安静地当没看见，不会报错，只会让你以为“跨项目文档不工作”。
