Shift+F12显示的引用数是语言服务器语义分析得出的真实去重统计值，准确反映被成功解析的调用、赋值等使用位置，排除纯类型声明和未导出/动态调用等不可静态分析场景。
Shift+F12 显示的引用数就是准确统计值
VSCode 的 Shift+F12（macOS 为 Cmd+Shift+F12）调用的是语言服务器的语义分析结果，顶部显示的「X references in Y files」是真实、去重后的引用计数，不是文本匹配数。它能识别作用域、导出/导入关系、重命名、类型守卫等上下文，所以比 Ctrl+Shift+F 全局搜更准。
这个数字只统计「被语言服务成功解析」的引用——也就是说，只要符号在编辑器里能跳转定义（F12 有效），它的引用数就可信。如果显示 No references found，不是没被引用，而是语言服务压根没“看见”它。
- 确保文件已保存：未保存的修改不会被语言服务器索引
- 检查状态栏语言模式：必须是
TypeScript、JavaScript、Python (Pylance)等支持引用分析的语言，不能是Plain Text - TS/JS 项目必须有
tsconfig.json或jsconfig.json，哪怕内容只有{}；否则 LSP 无法建立完整项目上下文
为什么 CodeLens 显示的「12 references」和 Shift+F12 结果不一致
editor.codeLens 开启后，代码行上方会显示类似 12 references 的提示，但它和 Shift+F12 的统计逻辑不同：前者是轻量级缓存快照，可能滞后或未刷新；后者是实时触发的完整分析。尤其在刚改完代码、切换分支或重启 VSCode 后，CodeLens 数字容易卡在旧值。
真正要确认引用总数，别信 CodeLens 顶上的小数字，直接按 Shift+F12 —— 它强制刷新索引并返回最新结果。如果你发现两者差 1～2 个，大概率是某个引用点涉及动态访问（如 obj[methodName]）、eval、或未导出的局部变量，这些会被 Shift+F12 排除，但 CodeLens 有时会误报。
- CodeLens 不区分读/写引用，也不过滤类型声明（比如
interface X的声明处也会被计入） -
Shift+F12默认只列出「实际被调用/使用」的位置，排除纯类型引用（可通过设置"references.includeDeclaration": true手动开启） - 若需稳定对比，关闭 CodeLens：
"editor.codeLens": false，避免干扰判断
引用数为 0 但明明写了调用？排查这三处硬伤
最常被忽略的不是语法问题，而是工程配置断层。引用数为 0 时，90% 情况下不是代码写错了，而是 VSCode 根本没把相关文件纳入分析范围。
- 文件不在当前工作区：右键资源管理器顶部工作区名 → 「Add Folder to Workspace…」，把依赖模块目录加进来；单靠「Open Folder」打开子目录是不够的
- 路径别名未配置：TS/JS 项目用了
@/utils，但tsconfig.json的"baseUrl"和"paths"没配，语言服务无法解析别名导入，自然找不到引用 - Python 项目没启用 Pylance：默认 Python 扩展对引用支持极弱，必须在设置里设
"python.languageServer": "Pylance"，且pyproject.toml或pyrightconfig.json中声明了"include"路径
动态构造的调用（funcName = 'xxx'; this[funcName]()）永远无法被统计，这不是配置问题，是静态分析的天然边界——这时候只能退回到 Ctrl+Shift+F 搜字符串，但得手动排除误匹配。
想看引用分布而不仅是总数？用 References View 固定面板
默认 Shift+F12 弹出浮层（Peek），信息挤在一起，数都难数清。改成固定视图后，顶部明确标出总数，每个文件下列出所有引用行，并高亮显示调用片段，一眼就能看出「哪个页面引用最多」「有没有测试文件混在里面」。
改法只有一行："references.preferredLocation": "view"，加到项目根目录的 .vscode/settings.json 里（不要加到用户全局设置）。这样团队成员开项目时自动生效，避免有人用 Peek、有人用 View 导致协作理解偏差。
- References View 支持点击文件名快速跳转，也支持右键「Reveal in Explorer」定位文件位置
- 列表可排序：点击「File」列按字母排，点击「References」列按引用数降序，快速揪出高频使用点
- 注意：该视图依赖语言服务完成索引，首次打开可能延迟 1–3 秒，别急着关掉
真正麻烦的不是怎么查，而是查之前没意识到：VSCode 的引用统计不是“有没有”，而是“它知不知道”。配置漏一项，整个引用链就断在半路。所以每次新建项目，先跑通 F12 和 Shift+F12，比写第一行业务代码还重要。
