先确认语言服务是否真正就绪，再检查多根工作区路径配置、tsconfig.json/jsconfig.json或python.analysis.extraPaths设置，最后验证符号导出与模块解析规则。
符号引用查不到？先确认语言服务是否真正就绪
很多“找不到引用”的问题，其实不是功能失效，而是语言服务器还在初始化、没完成索引，或者压根没加载成功。VS Code 的 Shift+F12（查找所有引用）完全依赖语言服务返回的语义数据，不是文本扫描。
常见错误现象包括：光标放在函数名上，右键菜单里“查找所有引用”灰掉；或点击后只显示“无结果”，但你知道它明明被调用了。
- 打开 VS Code 底部状态栏，看左下角是否有
TypeScript Server、Pylance或对应语言服务的图标和状态（如 “Ready”、“Initializing…”） - 按
Ctrl+Shift+P打开命令面板，输入并运行Developer: Toggle Developer Tools，切到 Console 标签页，搜索error或failed，常能看到语言服务崩溃或路径解析失败的日志 - 对 TypeScript/JS 项目，确保根目录有有效的
tsconfig.json或jsconfig.json，且include字段覆盖了所有源码目录（比如"include": ["src/**/*", "packages/**/*"]） - Python 用户需检查
python.analysis.extraPaths是否添加了跨包引用的路径，否则import mylib.utils中的utils符号根本不会被解析进当前上下文
跨文件/跨工作区引用不出现？检查多根配置与路径可见性
单个项目里引用能跳转，但加了另一个子模块后，“查找所有引用”就漏掉那边的调用——这几乎 100% 是路径未被语言服务感知所致。VS Code 不会自动把“打开的文件夹”都纳入符号分析范围，除非显式配置。
使用多根工作区是基础，但仅靠 File > Add Folder to Workspace 还不够。
- 保存工作区为
.code-workspace文件，并在其中手动确认各文件夹路径正确，例如：{ "folders": [ { "path": "backend" }, { "path": "frontend" } ] } - TypeScript/JS 项目必须在任一文件夹根目录提供
tsconfig.json，且其compilerOptions.baseUrl和paths（如有）要与实际 import 路径匹配；否则import { foo } from "@utils"中的@utils无法解析为真实路径，引用自然丢失 - 对于 Python，
python.defaultInterpreterPath必须指向包含所有依赖的虚拟环境，且python.analysis.extraPaths需明确列出其他项目的src或lib目录（不能只写父目录） - 重启语言服务：命令面板中运行
TypeScript: Restart TS server或Python: Restart Language Server，强制重建索引
为什么“查找所有引用”结果为空，但 Ctrl+F 能搜到？
这是最典型的语义 vs 文本混淆。当你用 Ctrl+F 搜到一个 handleClick，它可能出现在注释、字符串、日志、CSS class 名，甚至另一个同名但完全无关的模块里——而 Shift+F12 只返回被语言服务判定为“真正引用该符号”的位置。
换句话说：空结果 ≠ 没有调用，而是语言服务不认为那是有效引用。
- 检查目标符号是否被正确导出：TS/JS 中
function handleClick()若未加export，或在非模块文件（无import/export）中定义，则其他文件即使写了import { handleClick } from './xxx'，也可能因模块解析失败而不计入引用 - 局部变量、函数参数、
const声明的箭头函数若未被导出，通常不会出现在跨文件引用中（语言服务默认不索引非导出顶层符号） - React 组件内定义的事件处理器（如
const onClick = () => {...}）属于局部作用域，Shift+F12对它无效；只有命名函数声明 + 导出才支持全局引用追踪 - 如果确信调用存在但未显示，可临时在调用处加个
// @ts-ignore后保存，有时能触发语言服务重新评估该行语义
引用列表太多干扰项？用过滤和分组快速聚焦
Shift+F12 结果面板默认平铺所有引用，但在大型项目中常混入测试文件、类型声明、甚至 node_modules 里的副本。手动翻页效率极低。
VS Code 提供了轻量但实用的过滤能力，无需插件。
- 结果面板顶部有筛选按钮：“Group by Folder” 可按目录折叠，一眼看出哪些是 src、哪些是 test、哪些来自依赖
- 点击任意引用条目右侧的“⋯”菜单，可选择 “Show Only Write References” 或 “Show Only Read References”，对 setter/getter 或状态更新类逻辑特别有用
- 在搜索框中直接输入文件后缀（如
.test.ts）或路径关键词（如/mocks/），面板会实时过滤显示项 - 注意：这些过滤仅作用于当前结果集，不影响后续新触发的引用搜索；若想永久排除某些路径，需配置
search.exclude或语言服务专属设置（如typescript.preferences.includePackageJsonAutoImports关闭冗余导入建议）
Shift+F12，不如先花 30 秒看一眼状态栏和服务日志。 
