shift+f12显示“no references found”或无反应，根本原因是语言服务器未提供有效语义数据：状态栏显示plain text、console报lsp启动失败、缺tsconfig.json/jsconfig.json、文件未保存、被exclude排除、编码非utf-8或动态调用等均导致ast无法构建。
Shift+F12 显示“No references found”或根本没反应
这不是快捷键失灵，而是语言服务（Language Server）没提供有效语义数据。VSCode 的引用查找依赖 AST 解析和符号表构建，不是字符串匹配。
先看右下角状态栏：如果显示 Plain Text、Unknown 或语言名后带感叹号（如 TypeScript (error)），说明当前文件未被正确识别或语言服务崩溃。此时 Shift+F12 必然失效。
打开命令面板（Ctrl+Shift+P），运行 Developer: Toggle Developer Tools，切到 Console 标签页，搜 Failed to start 或 language server —— 常见报错如 Cannot find module 'typescript' 或 OmniSharp server not started 直接暴露根因。
对 JavaScript/TypeScript 项目，必须有 jsconfig.json 或 tsconfig.json，否则语言服务只扫描打开的文件，大量引用无法索引。空配置文件也比没有强：
{ "compilerOptions": { "allowJs": true }, "include": ["**/*.js", "**/*.ts"] }
Problems 面板为空但运行时报 ReferenceError
说明语言服务“没看见”问题，不是代码没错误——而是它压根没分析到那部分。
常见原因：
-
files.exclude或search.exclude里误加了源码目录（如"src/**"），导致语言服务跳过整个子树 - TS/JS 项目中，
tsconfig.json的include字段漏写了新文件路径（如新增了src/hooks/却没更新配置） - 文件编码不是 UTF-8（尤其含 BOM 头），解析器直接放弃处理
- 项目根目录下没有
package.json，某些 JS 扩展会降级为轻量模式，关闭语义分析
临时验证方法：把报错文件单独拖进一个全新 VSCode 窗口，不打开工作区，看 Problems 面板是否出现错误。如果有了，说明原工作区配置或缓存污染了语言服务。
大纲视图（Outline）和 Ctrl+Shift+O 都为空
这比 Shift+F12 失效更严重——说明语言服务连基本符号树都没构建出来。
典型触发场景：
- C# 项目中
OmniSharp未启动或日志报Could not resolve SDK，需检查.omnisharp/omnisharp.log - Python 项目没装 Pylance 或 Python 扩展禁用了语言服务器（设置里搜
python.languageServer，确保是Pylance） - Unity C# 项目中
.csproj文件缺失<targetframework></targetframework>或引用路径错误，OmniSharp 加载失败 - macOS 上 Mono 版本太低（
mono --version应 ≥6.12），或 VSCode 设置里omnisharp.monoPath指向了错误路径
强制重建符号索引：关闭所有文件 → Ctrl+Shift+P → 输入 Developer: Reload Window → 等状态栏语言图标停止旋转后再试。别跳过等待，索引是异步构建的。
重命名（F2）漏掉某些调用位置
这是设计使然，不是 bug。F2 只处理静态可推导的引用，动态场景天然排除在外。
明确不会被重命名覆盖的情况：
-
obj["user" + "Name"]或obj[key]（key 是变量） -
const x: any = {}; x.userName（any类型擦除了所有类型信息） - Vue Options API 中
methods: { handleClick() {} }，模板里@click="handleClick"在旧版 Vetur 下不参与重构 - JSX 属性名：
<button label="Save"></button>，除非Button的 TypeScript 定义里声明了label属性
遇到这类情况，别等 F2 自动补全——立刻切到 Ctrl+Shift+F，输入变量名，勾选 Match case 和 Match whole word，再人工确认上下文。字符串拼接的引用，往往得靠正则搜索，比如 obj\["[^"]*userName[^"]*"\]。
真正卡住的地方，从来不是快捷键记不记得住，而是你有没有第一时间去看 Output 面板里对应语言服务的日志——那里写的不是“找不到引用”，而是“为什么找不到”。
