F12跳转依赖语言服务器（LSP），失效主因是LSP未启动或文件未被正确识别；Ctrl+点击强制跳转，Alt+F12弹出只读Peek预览；Shift+F12漏引用因语义分析局限；Alt+←历史仅记录VSCode主动触发的导航。
F12 能跳转，不是 VSCode 自己“看懂了代码”，而是它把活儿交给了背后的语言服务器（LSP）——跳得快不快、准不准，取决于这个服务器有没有启动、建没建好索引、当前文件有没有被正确识别。
为什么按 F12 有时直接失效？
最常见原因不是快捷键坏了，而是语言服务器压根没起来，或者根本不知道你在写什么语言：
-
tsconfig.json缺失或路径不对 → TypeScript 项目里F12跳不到跨文件的接口定义 - Python 文件没被识别为
Python模式（右下角显示“Plain Text”）→ Pylance 不工作，Ctrl+点击变成纯文本搜索 - JavaScript 文件在没有
jsconfig.json的大型前端项目中 → 可能只跳到本文件，跨import就断连 - 扩展冲突：比如同时启用了
Python和Pylance旧版，或禁用了TypeScript and JavaScript Language Features
验证方式很简单：打开命令面板（Ctrl+Shift+P），输入 Developer: Toggle Developer Tools，切到 Console 标签页，搜 language server 或 failed，常能看到报错如 Cannot find module 'xxx' 或 no tsconfig.json found。
Ctrl+点击 和 Alt+F12 的本质区别是什么？
两者都走 LSP 的 textDocument/definition 请求，但处理方式不同：
-
Ctrl+点击（或F12）→ 强制打开目标文件并跳转，编辑焦点彻底离开当前上下文 -
Alt+F12→ 发起同样请求，但 VSCode 收到响应后不打开新标签，而是在当前编辑器内弹出一个可折叠的预览面板（Peek）
关键差异在于：Peek 面板里的代码是只读的，且不触发文件保存、格式化、Git 状态更新等副作用。适合快速确认参数类型或一行逻辑，改完立刻回原位继续写——尤其在调试时反复查某个工具函数定义，用 Alt+F12 比来回切标签高效得多。
为什么 Shift+F12 查引用有时漏掉调用点？
这不是 VSCode 的 bug，而是语言服务器的语义分析边界问题。例如：
- JavaScript 中通过字符串拼接动态调用：
const fnName = 'handle' + 'Click'; obj[fnName]();→Shift+F12基本找不到 - TypeScript 类型断言绕过检查：
(obj as any).someMethod()→ 可能不计入引用统计 - Python 中使用
getattr(obj, 'method_name')()→ Pylance 默认不追踪运行时字符串解析 - 未启用 “Implicit Project Configuration”（如 TS 的
allowJs: true或checkJs: true）→ JS 文件里的函数调用不会被 TS 服务器索引
解决思路不是硬刚，而是配合其他手段：先用 Shift+F12 找出明确引用，再用 Ctrl+Shift+F 全局搜函数名（注意加引号避免匹配注释），或打开 Outline 视图确认该符号是否被语言服务器真正识别为“可导出声明”。
跳转历史（Alt+←）为什么突然清空了？
VSCode 的导航历史栈是基于编辑器实例维护的，不是全局持久化。以下操作会清空它：
- 关闭并重新打开整个 VSCode 窗口（哪怕只是关掉最后一个标签页）
- 执行
Developer: Reload Window（常用但危险，会重置所有语言服务器连接和导航堆栈） - 手动修改
keybindings.json出错导致 VSCode 启动失败，自动恢复默认设置
真正容易被忽略的一点：Alt+← 只记录“由 VSCode 主动触发”的跳转，比如 F12、Shift+F12、Ctrl+T 搜索后点击、甚至鼠标侧键绑定的 workbench.action.navigateBack；但如果你手动点击侧边栏文件树切换文件，这个位置**不会进入导航历史**——所以别指望靠它返回到刚才点开的那个配置文件。
