shift+f12是首选，因其调用语言服务器进行语义级引用分析，精准返回有效使用点；f12仅转到定义，ctrl+shift+f为文本搜索易误匹配，均不满足“查谁用了它”的需求。
直接按 Shift+F12（Windows/Linux）或 Cmd+Shift+F12（macOS），光标必须停在完整符号名上——这是最可靠、最常用的方式，其他方法要么精度低，要么依赖额外配置。
为什么 Shift+F12 是首选，而不是 F12 或全文搜索
F12 是「转到定义」，它只会带你去声明处；而你要找的是「谁用了它」，这属于引用分析，必须由语言服务器基于 AST 索引完成。Ctrl+Shift+F 全局文本搜索虽然能搜到字符串，但会误匹配注释、字符串字面量、拼写相似的变量（比如搜 user 会命中 username 或 debugUser），且无法区分导入语句和实际调用。只有 Shift+F12 调用的是语言服务的真实语义引用分析，返回结果是经过类型检查过滤后的有效使用点。
Shift+F12 返回空列表？先检查这四件事
常见错误现象：明明写了 myHelper()，却查不到任何引用。
- 当前文件没保存——未保存的编辑内容不会被语言服务器索引，
Shift+F12只能看到已保存状态下的引用 - 光标落在符号非完整位置——比如停在
myHelper(的括号里，或只选中了Helper部分，语言服务无法识别为合法标识符 - 项目不在工作区中——VSCode 默认只索引「工作区根目录」及其子目录，如果文件是单独打开的（状态栏显示「No Folder Opened」），所有语义功能都会失效
- 语言支持未就绪——状态栏左下角显示
Plain Text或JavaScript React却没装对应扩展（如 TypeScript 项目缺tsconfig.json，Python 项目没启用Pylance）
跨文件、跨工作区引用怎么查才准
多根工作区是跨项目引用分析的基础前提，单靠文件夹嵌套或手动添加路径无效。
- 用「文件 > 将文件夹添加到工作区」把多个相关项目加入同一窗口，保存为
.code-workspace文件 - TypeScript/JS 项目必须有
jsconfig.json或tsconfig.json，哪怕内容只是{"compilerOptions": {"allowJs": true}} - Python 项目确保
"python.languageServer": "Pylance"（不是Jedi），并在设置中开启python.analysis.extraPaths指向依赖模块目录（如src或libs） - 若引用仍不显示，打开命令面板（
Ctrl+Shift+P），运行Developer: Toggle Developer Tools，查看 Console 中是否有LanguageClient报错（如Failed to resolve module）
查到了引用，但跳转进 .d.ts 文件怎么办
这是常见干扰项——语言服务优先返回类型声明而非实现源码，尤其在库函数或导出别名场景下。
- 尝试
Ctrl+Alt+Click（Windows/Linux）或Ctrl+Option+Click（macOS），部分语言服务支持强制跳转到实现 - 右键引用结果，选择「Go to Source Definition」（如果可用），比默认「Go to Definition」更倾向源码
- 检查该符号是否被
export type或declare module声明过，这类声明本身不产生运行时引用，Shift+F12列出的可能是类型使用点而非调用点 - 临时关闭类型检查（如 TS 中加
// @ts-ignore后重试）可验证是否为类型系统干扰，但不建议长期这么做
真正卡住的地方往往不是快捷键记错，而是语言服务没真正“看见”你的代码结构——工作区配置、配置文件存在性、扩展启用状态，这三者缺一不可。一旦其中任一环节断开，Shift+F12 就退化成摆设。
