Alt+F12是定义预览快捷键，以悬浮窗形式展示定义内容且不离开当前文件，但需语言服务就绪、光标位于可解析标识符上，否则显示空白或“Loading…”。
F12 跳转定义是直接离开当前文件去源码位置，Alt+F12 悬浮窗预览只是临时看一眼不跳转，Shift+F12 查找引用则是列出所有使用点（含定义）——三者目的、行为和触发时机完全不同。
Alt+F12 悬浮窗预览定义为什么有时不显示内容
这不是功能失效，而是语言服务尚未完成索引或当前符号不可解析：
- 文件未保存时，Pylance/TypeScript 语言服务可能忽略未持久化变更
- 变量声明在
eval()、with块或动态 import 中，语义分析无法静态推导 - Python 项目缺少
pyrightconfig.json或pyproject.toml配置，导致类型信息缺失 - 悬停时看到 “Loading…” 提示，说明语言服务器还在构建 AST，稍等几秒再试
Shift+F12 查找引用返回结果为空的常见原因
它不是文本搜索，依赖完整语义建模，空结果往往意味着语言服务“没看见”这个变量：
- 变量定义在
node_modules或dist目录下，VSCode 默认排除这些路径（需在jsconfig.json的exclude字段中显式移除） - TypeScript 项目没有
tsconfig.json，哪怕只写{"compilerOptions": {"allowJs": true}}也能激活基础支持 - JavaScript 文件中变量未标注 JSDoc 类型（如
/** @type {string} */），导致引用链断裂 - 变量名拼写正确但作用域受限（如函数内
const变量被闭包捕获后，在外部模块无法被识别为同一符号）
F12 跳转定义失败时，别急着换插件
先确认是否真属于“定义不可达”，而不是“定义不在预期位置”：
- 点击后跳转到
node_modules里的声明？说明你装了类型包（如@types/react），但源码未启用sourceMap或未配置"types": ["react"] - 跳转到
declare语句而非实现？这是 TypeScript 的正常行为，用Go to Implementation（右键菜单或Ctrl+Shift+F12）才能进到实际函数体 - Python 中
from module import *导入的变量，Pylance 默认不解析，改用明确导入（from module import func）或加# pyright: reportUnknownVariableType=false - 按下 F12 后光标闪一下没反应？检查左下角状态栏是否显示 “No definition found” —— 这比弹窗报错更可信
真正容易被忽略的是：Alt+F12 和 Shift+F12 都要求符号已“进入语言服务视野”。刚打开一个新分支、新仓库，或切换了 Git 分支后首次打开文件，务必先等待右下角提示 “Indexing…” 消失。强行操作只会得到空结果或错误跳转。
