Shift+F12跨文件引用需语言服务完整索引项目：检查tsconfig/jsconfig配置、多根工作区手动添加、子项目配置一致、启用对应语言模式，并善用结果面板分组与筛选功能。
能查，但必须满足语言服务已正确索引整个项目结构——否则“跨文件”三个字就只是个幻觉。
为什么Shift+F12有时只显示当前文件的引用
这不是快捷键失效，而是语言服务器（如 TypeScript 的 tsserver、Python 的 Pylance）压根没把其他文件纳入语义分析范围。常见原因包括：
-
tsconfig.json或jsconfig.json缺失，或include字段漏写了子目录（比如只写了["src"]却没加"src/**/*"） - 多根工作区中，某个子项目没被语言服务识别——检查该文件夹下是否有合法的配置文件（如
pyproject.toml或rust-project.json） - 文件后缀不被识别（例如
.jsx在纯 JS 项目里可能被跳过，需确认 JavaScript 语言模式已启用 JSX 支持） - 符号本身是动态生成的（如
const key = 'foo'; obj[key] = 1），这类引用无法被静态分析捕获
多根工作区必须显式添加，不能靠“打开文件夹”自动合并
VSCode 不会自动把多个同级文件夹当作一个逻辑项目。要让 Shift+F12 真正跨项目生效，得手动构建多根工作区：
- 用 “文件 > 将文件夹添加到工作区” 逐个加入相关项目（不是“打开文件夹”）
- 保存为
.code-workspace文件，确保所有路径都出现在folders数组里 - 在每个子项目根目录下放置对应语言配置（如
tsconfig.json），且baseUrl和paths映射要一致，否则别名导入（如@utils/xxx）的引用会断掉
引用结果面板里容易忽略的筛选和分组功能
默认展开的引用列表看起来平铺直叙，其实藏着几个关键操作点：
- 点击结果面板右上角的“分组依据”下拉框，可切换为
按文件夹分组—— 这对判断是否真跨了文件特别直观 - 勾选“只显示写入引用”能快速定位赋值、修改位置（比如
user.name = 'x'），避免被大量读取干扰 - 鼠标悬停在某条引用上，会浮出上下文代码片段；双击它才真正跳转，单击只是选中
- 如果引用路径显示为
node_modules/xxx，说明语言服务正在解析第三方类型定义，此时需确认types或typeRoots配置是否合理
跨文件引用不是开箱即用的功能，它是语言服务、项目配置、工作区结构三者对齐后的副产品。任何一个环节松动，Shift+F12 就会退化成“查找当前文件里出现过这个词的地方”。
