Shift+F12查不到跨文件引用并非快捷键失效，而是语言服务未索引目标文件：常见原因包括tsconfig.json/jsconfig.json的include未覆盖子路径、Python未启用Pylance或extraPaths缺失、文件不在工作区、未保存修改。
直接按 Shift+F12（Windows/Linux）或 Cmd+Shift+F12（macOS）即可查看跨文件符号引用，但前提是语言服务已正确索引全部相关文件 —— 否则只会返回空结果或仅匹配字符串。
为什么 Shift+F12 有时查不到跨文件引用
这不是快捷键失效，而是语义分析没覆盖到目标文件。常见原因包括：
-
tsconfig.json或jsconfig.json的"include"没包含子项目路径，TypeScript/JS 语言服务器只认配置范围内的文件 - Python 项目未启用
Pylance，或python.analysis.extraPaths没添加其他模块所在目录 - 引用文件不在当前工作区：VSCode 默认只分析“EXPLORER”顶部列出的文件夹，单独打开的文件或外部路径不会被索引
- 文件未保存：语言服务器通常不处理脏缓冲区（unsaved changes），临时修改不会参与引用建模
确保跨文件引用可被识别的关键配置
不同语言需对应配置，否则 Find All References 只能做文本级匹配：
- TypeScript/JavaScript：在项目根目录放
tsconfig.json，确保"include"包含所有源码目录，例如["src/**/*", "packages/**/*"] - Python：在设置中启用
"python.languageServer": "Pylance"，并配置python.analysis.extraPaths指向其他项目的src或lib目录 - 多根工作区：用“文件 > 将文件夹添加到工作区”把多个项目加入同一窗口，再保存为
.code-workspace文件，这是跨项目跳转最稳定的方式
查不到时的快速验证步骤
别反复重试，先确认语言服务是否就位：
- 打开 VSCode 输出面板（
Ctrl+Shift+U），切换到TypeScript或Pylance日志，看是否有indexing completed或类似提示 - 右键目标符号，如果菜单里
Go to Definition也点不动，说明定义本身就没被识别，引用自然无从谈起 - 尝试手动触发
Restart TS Server（命令面板输入该命令）或Developer: Restart Language Server - 对 Python，检查
python.defaultInterpreterPath是否指向正确虚拟环境，pyproject.toml中的[tool.pyright]配置是否生效
跨文件引用不是“开箱即用”的功能，它依赖语言服务器对整个上下文的静态建模。最容易被忽略的是：你以为加了文件夹进窗口就等于被索引了，其实还得看配置是否让语言服务“看见”它们 —— 路径写错一位、漏掉一个通配符、或者用了相对路径但工作区根设错了，都会导致引用列表为空。
