跨文件符号引用需语言服务器正确加载并索引，常见失效原因是配置未覆盖目标文件，如tsconfig.json漏include子目录或Python未配extraPaths；验证应以悬停类型提示和F12/Shift+F12行为为准，而非右键菜单。
能跨文件检索符号引用，前提是语言服务器已正确加载并完成索引——不是所有“看起来能跳转”的情况都代表引用能被完整识别。
为什么 Shift+F12 没反应或只显示当前文件的引用
最常见原因是语言服务没覆盖到目标文件。比如 TypeScript 项目里，tsconfig.json 的 include 字段漏写了子目录，或 Python 项目没在 python.analysis.extraPaths 中加入其他模块路径。VSCode 不会自动把工作区里所有文件都纳入语义分析，它只信任配置声明的“源码范围”。
- 检查输出面板（View > Output），切换到对应语言服务（如 “TypeScript Server” 或 “Pylance”），看是否有
Failed to load configuration或Skipping folder类警告 - TypeScript/JS 项目必须有有效的
tsconfig.json或jsconfig.json，且不能是空文件或语法错误 - Python 项目若引用了本地未安装的包，仅靠
python.defaultInterpreter不够，必须显式配置python.analysis.extraPaths - 多根工作区中，每个文件夹需各自满足上述条件；VSCode 不会用 A 文件夹的 tsconfig 去解析 B 文件夹的文件
如何确认符号引用是否真被识别
别依赖“右键菜单有没有‘查找所有引用’”，而要看光标悬停时是否显示准确的类型信息和定义位置。如果悬停只显示 any 或 unknown，或者“转到定义”（F12）跳转失败，那引用检索大概率不可靠。
- 将光标停在目标符号上，等待 1–2 秒，看右下角状态栏是否出现
defined in ./xxx.ts这类提示 - 按住 Ctrl（macOS 是 Cmd）再鼠标悬停，应能触发“预览定义”浮层；若浮层空白或报错，说明 AST 解析中断
- 对同一个符号，在不同文件中分别试 F12 和 Shift+F12：如果 F12 能跳转但 Shift+F12 没结果，通常是该文件未被语言服务索引（例如被
exclude规则意外屏蔽）
search.exclude 会静默破坏引用检索
search.exclude 只控制文本搜索，不影响语言服务——但很多人误以为它也影响符号引用，于是删掉 "**/node_modules": true 后发现引用列表变多了。其实不是“变多”，而是之前因路径缺失导致语言服务启动失败，现在修复后才真正开始工作。
- 真正影响引用识别的是语言服务自身的路径配置（如
tsconfig.json的include、compilerOptions.baseUrl），不是search.exclude - 但如果你把 src/ 下某个子目录加进了
search.exclude，而该目录恰好是tsconfig.json声明的入口之一，语言服务可能因读不到文件而降级为局部解析 - 验证方法：临时注释掉
search.exclude里所有条目，重启 VSCode，再试 Shift+F12；如果结果明显增多，说明之前有路径冲突
跨工作区引用需要多根 + 显式路径联动
单纯把两个文件夹拖进一个窗口（多根工作区）不等于自动打通符号。TypeScript 项目 A 引用项目 B 的导出，必须让 A 的 tsconfig.json 知道 B 的位置，否则即使 B 在工作区里，A 里 import 的符号也会被标记为 Cannot find module，自然无法追踪引用。
- 推荐做法：在 A 的
tsconfig.json中设置"baseUrl": "./"和"paths": { "@b/*": ["../B/src/*"] }，然后确保 B 的src目录在 A 的include范围内 - Python 同理：B 的根目录要加进 A 的
python.analysis.extraPaths，且 B 自身要有pyproject.toml或__init__.py让 Pylance 识别为可导入包 - 不要依赖“同工作区就自动可见”——VSCode 的符号服务是 per-folder 的，跨文件夹引用必须显式声明依赖关系
最容易被忽略的点：语言服务启动顺序和缓存。改完 tsconfig.json 后不重启 VSCode，或清过 ~/.vscode/extensions/.../cache 却没重载窗口，都会导致旧索引残留。真要验证，关掉所有窗口，重新用 code /path/to/workspace 打开，再等 10 秒看输出面板日志是否刷出 Found 1234 symbols 这类信息。
