Alt+F12和Alt+点击均触发editor.action.peekDefinition命令，实现就地预览定义而不跳转；失效主因是语言服务器未就绪或符号不可解析，如配置缺失、文件未保存、路径错误等。
Alt + 点击不是跳转，是“预览定义”
Alt + 点击（Windows/Linux）或 Option + 点击（macOS）在 VSCode 中触发的是 editor.action.peekDefinition 命令，效果等同于快捷键 Alt+F12 —— 它不会离开当前文件，而是在悬浮面板里就地展示变量或函数的声明内容。这比 F12 跳转更轻量，适合快速确认类型、参数或实现逻辑，尤其当你不想中断编辑上下文时。
为什么 Alt + 点击后显示 “Loading…” 或空白
这不是快捷键失效，而是语言服务没准备好或符号不可解析。常见原因包括：
-
tsconfig.json或jsconfig.json缺失（JS/TS 项目必须有，哪怕只写{"compilerOptions": {"allowJs": true}}） - Python 项目未启用 Pylance，或
python.languageServer设置为Pylance（不是Default或Jedi） - 文件未保存：Pylance/TypeScript 服务通常忽略未持久化的变更
- 变量定义在
eval()、new Function()、动态import()或 JSDoc 错误路径中（如@type {import('./missing').X}） - 刚切换 Git 分支，右下角仍显示
Indexing…，此时所有预览都不可靠
Alt + 点击 vs F12：什么时候该用哪个
两者依赖同一套语言服务，但行为目标不同：
- 用
Alt+F12或Alt + 点击：想快速扫一眼定义，不离开当前行，比如确认某个ref()的返回类型，或看一个工具函数的入参是否带optional - 用
F12：需要深入修改定义本身，比如进到某个 hook 内部调整逻辑，或重命名导出名 - 注意：在 Vue SFC 的
setup()里对const count = ref(0)执行Alt + 点击，会预览ref函数实现，不是count声明处——这是响应式包装的正常表现，不是 bug
容易被忽略的兼容性细节
Alt + 点击的可用性高度依赖语言服务的粒度和配置：
- TypeScript 中若用了
(obj as any).method()绕过类型检查，预览会断链，找不到真正定义 - JSX 里点击
onClick={handleClick}中的handleClick，可能预览失败——需确保已安装@types/react且jsconfig.json启用类型自动导入："javascript.preferences.includePackageJsonAutoImports": "auto" - 引用来自未纳入工作区的目录（比如
../shared/utils没加进 VSCode 工作区列表），即使物理路径存在，Alt + 点击也查不到 - 动态拼接的调用（
const fnName = 'fetch' + 'Data'; window[fnName]();）天然无法被语义分析捕获，Alt + 点击无响应是预期行为
真正卡住的往往不是快捷键按错，而是语言服务根本没拿到可解析的 AST。先看右下角语言模式、再开 Developer Tools 查 Console 报错，比反复重装扩展更有效。
