必须配置多根工作区（.code-workspace）并统一语言服务索引：显式声明所有文件夹路径、在工作区根目录配置tsconfig.json的include字段或Python的python.analysis.extraPaths，且重启语言服务器。
VSCode 默认不跨工作区索引符号，所谓“不同工作区”之间查引用，本质是让语言服务器把多个目录当成一个逻辑项目来处理——否则 Shift+F12 只会返回当前打开工作区（或当前文件所在根目录）里的结果。
多根工作区（.code-workspace）是前提
单靠“同时打开两个文件夹窗口”不行，必须合并为一个多根工作区。VSCode 只对 .code-workspace 文件中显式声明的文件夹统一构建语言服务索引。
- 用“文件 > 将文件夹添加到工作区”依次加入相关项目目录
- 保存为
myproject.code-workspace，不要只靠“最近打开”或“单独窗口” - 关闭所有窗口，重新用该
.code-workspace文件打开，确保右下角显示“工作区”而非“文件夹” - 检查状态栏语言标识是否正常（如 TypeScript、Python），异常说明语言服务未加载全部路径
tsconfig.json 或 jsconfig.json 必须覆盖所有子项目
TypeScript/JavaScript 项目中，语言服务器只扫描 include 字段列出的路径。即使加进了工作区，如果配置没扩进去，Shift+F12 依然找不到跨目录引用。
- 在工作区根目录（不是某个子项目里）放一份
tsconfig.json，include显式列出所有子项目源码路径，例如："include": ["frontend/src/**/*", "shared-lib/src/**/*", "backend/src/**/*"] - 避免用
**/*.ts这种宽泛写法——它可能被忽略或匹配不到深层嵌套结构 - 确认每个子项目没有独立的、冲突的
tsconfig.json覆盖了全局配置（尤其是extends或compilerOptions中的baseUrl） - 改完配置后重启 TS 语言服务器：按
Ctrl+Shift+P输入 “TypeScript: Restart TS server”
Python 项目要配 python.analysis.extraPaths
Pylance 不自动扫描工作区里所有文件夹，得手动告诉它哪些路径含可导入模块。
- 在
settings.json（工作区级优先）中添加："python.analysis.extraPaths": ["./shared-utils", "./api-client"] - 路径是相对于工作区根目录的，不能用绝对路径或
../ - 确保这些路径下有
__init__.py（哪怕空文件），否则 Pylance 不识别为包 - 若引用的是未安装的本地包，还需在对应目录运行
pip install -e .，否则类型推导和引用分析会断
为什么 Shift+F12 还是没结果？重点检查这三处
符号引用搜不到，90% 是语言服务根本没看到那个文件——不是快捷键问题，也不是 UI bug。
-
Ctrl+Space在目标符号上没类型提示 → 语言服务未加载该文件，先看右下角语言模式是否正确（比如显示 “Plain Text” 却该是 “TypeScript”） - 打开 VSCode 输出面板（
Ctrl+Shift+U），选 “TypeScript” 或 “Python” 日志，搜索Failed to resolve或no config file - 目标文件没保存（灰色标题栏）→ ripgrep 能搜到文本，但语言服务器不索引未保存文件，
Shift+F12必然为空
真正跨工作区的引用分析，从来不是“开个新窗口就能查”，而是把多个物理目录通过配置收束成一个语义上下文。漏掉 .code-workspace、tsconfig.json include 或 extraPaths 中任意一环，Shift+F12 都只会安静地返回空面板——它不是失败，只是诚实地告诉你：“我根本没见过那个符号”。
