f12跳转、shift+f12查引用、alt+f12预览定义的前提是语言服务正常运行且符号被静态分析识别；需检查状态栏语言模式、console错误、tsconfig/jsconfig配置、pylance启用状态及索引完成情况。
F12 跳转定义、Shift+F12 查引用、Alt+F12 预览定义——这三个操作能用的前提不是快捷键按对了，而是语言服务真正在跑，且当前符号已被静态分析识别。
为什么 F12 按了没反应？先看状态栏和控制台
不是快捷键失效，是 VSCode 根本没拿到语义信息。常见表现包括：光标悬停只显示 any 或 unknown，F12 后提示 No definition found，或右下角状态栏没显示 Python (Pylance) / TypeScript 等有效语言模式。
- 打开命令面板（
Ctrl+Shift+P），运行Developer: Toggle Developer Tools，切到 Console 标签，搜Failed to start language server或error - 检查文件顶部语言模式：右下角必须是
JavaScript，不能是Plain Text；临时改成其他语言再改回来会清空索引，得重等 - TypeScript/JavaScript 项目必须有
tsconfig.json或jsconfig.json，哪怕只有{"compilerOptions": {"allowJs": true}} - Python 项目确认已启用 Pylance（不只是装了 Python 扩展），且设置中
python.languageServer设为Pylance
Shift+F12 查不到引用？它不认动态代码
Shift+F12 是基于 AST 的静态分析，不是 grep。它天然无法覆盖以下场景：
- 字符串拼接调用：
const fnName = 'handle' + 'Click'; window[fnName](); - 未被
import的模块里定义的变量（即使物理路径存在，但工作区没包含该目录） -
eval()、new Function()、with块内声明的符号 - JavaScript 中
var声明的变量在函数外不可见，或被闭包捕获后跨模块丢失作用域关联 - TypeScript 中用
(obj as any).method()绕过类型检查，引用链就断了
Alt+F12 预览定义为什么空白或“Loading…”？
这不是功能坏了，是语言服务还没完成索引，或当前符号不可解析：
- 文件未保存时，Pylance/TypeScript 语言服务可能忽略未持久化变更
- 变量定义在
eval()、动态import()或 JSDoc 类型注释写错路径（比如@type {import('./wrong-path').X}） - Python 项目缺少
pyrightconfig.json或pyproject.toml，导致类型信息缺失 - 刚切换 Git 分支或打开新仓库，右下角还在显示
Indexing…，此时所有跳转都不可靠
CodeLens 显示“12 references”但点不动？默认是关的
很多人发现变量上方有数字但点击无反应——这不是 Bug，是 editor.codeLens 默认关闭。
- 打开设置（
Ctrl+,），搜索editor.codeLens，勾选Editor > Code Lens: Enabled - TypeScript 还需额外开启：
Typescript > Preferences: Implementations Code Lens - 注意：CodeLens 数字只是快照，真要展开列表，仍需手动按
Shift+F12或Alt+Click
真正容易被忽略的是：所有跳转行为都依赖语言服务把整个工作区“读进去”。刚拉完代码、切完分支、或新增了 tsconfig.json，别急着操作——等右下角 Indexing… 提示消失再说。
