根本原因是语言服务未将整个项目作为统一上下文索引：typescript缺tsconfig.json、vue未启用volar、多项目未配置references或paths，导致跨文件引用不可见。
为什么 Shift+F12 查不到跨文件引用
根本原因不是功能坏了，而是语言服务没把整个项目当一个上下文来索引。比如 TypeScript 项目没配 tsconfig.json，或 Vue 项目没启用 Volar，VSCode 就只能看到当前打开的文件，其他文件里的 import 和调用压根不进索引。
常见表现：光标停在组件名上按 Shift+F12，结果只显示“0 个引用”，或者只列出当前文件里的几处；但明明在 pages/UserList.vue 里 import 并用了它，却完全不出现。
- 检查项目根目录有没有
tsconfig.json或jsconfig.json；没有就建一个，至少包含{"include": ["**/*.ts", "**/*.tsx", "**/*.js"]} - Vue 项目务必禁用旧版
Vetur，启用Volar（并在设置里勾选 “Take over mode”） - 打开 VSCode 输出面板（
Ctrl+Shift+U），切换到TypeScript Server或Volar标签页，看有没有报错如 “Failed to load configuration file”
多项目共存时引用总漏掉几个文件
你把 client 和 shared 两个文件夹拖进同一个 VSCode 窗口，以为自动就打通了——其实不会。默认情况下，语言服务器只认“主工作区”的配置，shared 里的类型定义、导出函数，在 client 里是不可见的。
必须显式告诉语言服务：“这些目录也属于我这个上下文”。TypeScript/JS 项目靠 tsconfig.json 的 paths 或 reference，Python 靠 python.analysis.extraPaths。
- TypeScript：在
tsconfig.json里加"references": [{"path": "../shared"}]，然后运行tsc --build触发增量构建 - 更轻量的做法：在
tsconfig.json的compilerOptions里加"baseUrl": ".", "paths": {"@shared/*": ["../shared/*"]}，再确保所有 import 都用这个别名 - 确认生效：随便打开一个引用
@shared/utils的文件，把光标放在utils上按F12，能跳转过去才算成功
搜索结果太多，真正有用的引用被淹没
Ctrl+Shift+F 全局搜组件名，出来 300 条，其中 200 条是注释、字符串路径、甚至 node_modules 里的第三方库代码——这不是 VSCode 慢，是你没过滤。
真正该用的是语义级查找：Shift+F12 给出的是“被语言服务确认为有效引用”的位置，而 Ctrl+Shift+F 是纯文本暴力匹配。两者目的完全不同，不能混用。
- 先试
Shift+F12；如果结果为空或太少，回头检查上一条说的语言服务配置 - 如果确实需要文本搜索（比如查某个特定 props 名是否被传入），在
Ctrl+Shift+F的 “files to include” 栏填src/**/*.{js,ts,jsx,tsx,vue}，排除node_modules、dist、__tests__ - 加个正则前缀避免误匹配：搜
MyComponent时，用单词边界\bMyComponent\b，避免匹配到MyComponentWrapper
重命名后部分引用没更新，甚至改错了地方
按 F2 重命名一个函数，结果 utils/api.ts 里那个同名的私有工具函数也被改了——说明语言服务没区分作用域，把不同文件里独立声明的同名符号当成一个东西了。
这通常发生在没开严格模式、或文件没被正确识别为模块（比如缺少 export 或 import）的情况下。TS/JS 默认把无导入导出的文件当作“全局脚本”，所有顶层变量都挂到全局作用域。
- 确保每个文件至少有一个
import或export，让语言服务把它识别为 ES 模块 - TypeScript 项目开启
"compilerOptions": {"isolatedModules": true}，强制模块化检查 - 重命名前留意右下角预览：VSCode 会在弹窗里显示“将在 X 处修改”，点开看看列表里有没有明显不该动的路径（比如测试文件、mock 数据）
Shift+F12 或 F2 时，你心里清楚：这个结果是语言服务基于 AST 推出来的，不是 grep 猜的。一旦配置到位，漏引、错引、跨项目失效这些问题，就从“玄学排查”变成“配置即解决”。
