VSCode符号搜索失效的主因是语言服务器未正确加载或识别文件类型，需检查右下角语言模式、项目配置文件、代码静态可分析性及索引状态。
语言服务器根本没加载或识别错文件类型
右下角显示 Plain Text 就别指望能搜到引用——VSCode 的符号功能完全依赖语言服务器（如 TypeScript Server、Pylance、OmniSharp）启动并正确识别文件。哪怕你写的是 .ts 文件，如果状态栏没显示 TypeScript，说明它被当作文本处理，连语法高亮都可能没有，更别说建模引用关系。
- 点击右下角语言模式，手动选成对应语言（
TypeScript、Python、C#），别等自动识别 - 检查文件是否真以
.py、.cs等后缀保存；临时存成script.txt或main（无后缀）会导致 Pylance/OmniSharp 直接跳过 - 打开命令面板（
Ctrl+Shift+P），运行Developer: Toggle Developer Tools，切到Console标签页，搜LSP或server，看是否有Failed to start或连接超时日志
项目配置缺失或不合法，导致索引范围为空
JavaScript/TypeScript 项目没 jsconfig.json 或 tsconfig.json，Python 项目没 pyproject.toml 或解释器路径配错，C# 项目缺 .csproj 或 .sln，都会让语言服务器“不知道该扫哪”。不是它不想搜，是它压根没把你的源码目录纳入视野。
- TS/JS 最小可用配置必须含
"include"字段，例如："include": ["src/**/*", "test/**/*"]；漏掉src/utils，里面导出的函数在别处调用就会标红且查不到引用 - Python 要确认
python.defaultInterpreterPath指向一个已安装pylance的环境（pip show pylance可验证） - C# 项目若为 Unity，需确保
.csproj文件存在且未被files.exclude规则排除；bin、obj、Library目录干扰时，删掉它们再重启 OmniSharp
代码本身超出静态分析能力边界
语言服务器不是运行时，它只做静态推导。一旦涉及动态行为，引用关系就天然断裂——这不是 bug，是设计限制。你写的那行调用，它“看见”了，但不敢确认是不是真会执行。
-
obj[methodName]()、eval()、new Function()、require(dynamicPath)这类写法，所有主流语言服务器一律放弃建模 - 未导出的私有声明（如
const helper = () => {}未加export）在其他文件中即使能访问，也不会出现在引用列表里 - Vue Options API 的
methods: { handleClick() {} }在旧版 Vetur 下无法反向追踪；Composition API 中setup() { return { handleClick } }才可被可靠索引 - JS 文件若
jsconfig.json未设"compilerOptions": {"allowJs": true}，对.js文件的引用可能被忽略
索引未完成、缓存损坏或未保存的代码不参与分析
VSCode 的引用搜索不是实时 grep，它依赖后台构建的符号数据库。这个库需要时间生成、也会因缓存污染失效。而最常被忽略的前提是：**只有已保存的代码才被索引**。
- 刚写完
myFunc()就按Shift+F12，文件没 Ctrl+S，语言服务器根本看不到这行——它只认磁盘上的内容 - 首次打开大型 Python 项目时，右下角显示
Indexing Python files...，期间Ctrl+T返回空结果属正常，不是功能坏了 - 重置索引不能只靠重启 VSCode：先运行
Python: Restart Language Server（或对应语言命令），再Developer: Reload Window，最后手动删缓存目录（如~/.vscode/extensions/ms-python.pylance-*/out） - 某些杀软会锁住
.vscode/extensions/下的缓存文件，导致索引卡死；临时禁用实时防护可快速验证
真正容易被忽略的是：引用搜索的结果，永远只反映「当前已保存 + 已索引 + 静态可推导」的代码状态。任何一环断开，它就沉默——不是拒绝服务，是没东西可返回。
