vscode代码导航依赖语言服务器（lsp），非自身解析逻辑；跳转失效主因是语言模式错误、配置缺失（如tsconfig.json）、文件未保存或服务未启动；快捷键需配合正确配置与插件（如volar）才生效。
VSCode 本身不解析“代码逻辑”，只依赖语言服务器（LSP）提供的符号信息做导航；所谓“按逻辑跳转”，本质是用对的快捷键 + 正确的语言服务配置，把函数调用链、类型推导、引用关系这些语义信息显性化出来。
Ctrl+Click 跳不到定义？先看右下角语言标识
很多“跳转失效”不是快捷键问题，而是 VSCode 根本没把当前文件当目标语言处理。比如打开 utils.ts 却显示“Plain Text”，F12 或 Ctrl+Click 就只能干瞪眼。
- 右下角状态栏必须显示
TypeScript、Python或对应语言名；点它可手动切换语言模式 - 对 JS/TS 项目，根目录必须有
tsconfig.json或jsconfig.json，否则跨文件跳转会退化为仅当前文件内搜索 - 新建未保存的文件（unsaved file）常被语言服务器忽略，先
Ctrl+S再试 - 打开开发者工具（
Ctrl+Shift+I），Console 里搜Starting language server，确认服务已启动且无报错
Ctrl+P 输入 @xxx 没反应？检查符号索引是否就绪
Ctrl+P 后输 @ 是查当前文件符号，但结果为空 ≠ 快捷键坏了，而是语言服务没返回 AST 结构。
- 常见原因：文件后缀不被识别（如
.jsx未启用javascript.preferences.jsxAttributeCompletion）、tsconfig.json的include没覆盖该文件路径 - 验证方式：命令面板运行
Developer: Toggle Developer Tools，看 Console 是否报Failed to resolve workspace symbols - 临时补救：输入
@xxx后按Tab，VSCode 会 fallback 到文本搜索（显示 “Search text in workspace”） - 注意：
@只查当前文件，#才查整个工作区，但#依赖跨文件索引，漏结果常因files.exclude误删了源码目录
Ctrl+Shift+O 只显示 template？Vue/React 文件需插件配合
Ctrl+Shift+O 调出的是基于 AST 的大纲视图，不是 HTML 解析器。Vue 单文件组件默认只解析 <template></template>，React 函数组件若用表达式赋值（const Foo = () => {}）也可能不识别。
- Vue 项目必须装官方
Volar插件，并在设置中禁用旧版Vetur，否则大纲只显示模板结构 - React 项目确保启用了
javascript.suggest.autoImports，否则自定义 Hook（如useFetch）可能不进大纲 - 连续按两次
Ctrl+Shift+O进入筛选模式，输@function或@class可过滤类型，比滚动快得多 - 大纲右上角漏斗图标可关闭
Variables，聚焦高层级结构，避免被一堆const干扰
跳转后找不到上下文？别只靠 F12，搭配导航历史和引用链
单次 F12 只解决“定义在哪”，但大型项目真正卡住的是“它被谁调用”“它又调了谁”。纯靠跳转容易迷路。
- 跳转后用
Ctrl+Alt+←（Windows/Linux）或Cmd+Alt+←（macOS）秒回上一位置，→前进，比鼠标点“返回”快得多 - 光标停在函数名上，按
Shift+F12查所有引用，侧边栏列出全部调用点，点任一即可跳转 - 想看调用链深度？
Ctrl+Shift+P运行Go to References后，再对引用点重复操作，形成手动 call stack - 对类型敏感的场景（如 TypeScript 接口实现），用
Ctrl+Shift+F12（Go to Type Definition）比F12更准
真正卡住人的从来不是快捷键记不住，而是语言服务没跑起来、配置文件没生效、或者误把文本搜索当语义导航用。每次跳转失败，先看右下角语言标识和开发者工具 Console，比重装插件管用得多。
