Ctrl+点击跳转定义依赖LSP的textDocument/definition请求，需语言服务就位；若失效，优先检查状态栏语言模式、服务器运行状态及配置文件（如tsconfig.json/jsconfig.json）。
Ctrl+点击跳转定义：不是所有符号都支持，得看语言服务是否就位
VSCode 的 Ctrl+点击（macOS 是 Cmd+点击）能跳转到定义，前提是当前文件的语言服务已激活且返回了有效位置。它不是靠正则匹配，而是调用 LSP 的 textDocument/definition 请求。如果点不动，大概率是语言服务器没起来、没响应，或者你点的位置根本没被识别为“可解析符号”。
常见错误现象：
- 在 JS/TS 文件里点函数名没反应 → 检查右下角状态栏是否有 TypeScript 语言服务器正在运行，或打开输出面板切换到
Typescript查看错误日志 - Python 文件里点
import模块名跳不到 → 确认已安装Pylance或配置了正确python.defaultInterpreterPath - 点
package.json里的依赖名没跳转 → 默认不支持，需插件（如npm-intellisense）注册registerDefinitionProvider
性能影响：每次点击都会触发一次 LSP 请求，大型项目首次跳转可能有几百毫秒延迟，属于正常现象；若持续卡顿，检查语言服务器 CPU 占用或禁用其他干扰插件。
Alt+点击快速添加光标：和跳转无关，但常被误认为“另一种跳转”
Alt+点击（Windows/Linux）或 Option+点击（macOS）是多光标编辑操作，不是跳转命令。它会在点击处插入一个新光标，方便批量修改。很多人以为这是“跳转到定义的替代方式”，其实是混淆了功能。
关键区别：
-
Ctrl+点击：触发editor.action.revealDefinition，目标是跳转 -
Alt+点击：触发editor.action.addCursorAtPointer，目标是编辑 - 两者底层命令不同，快捷键不可互换，也不共享缓存或语言服务上下文
容易踩的坑：在设置了 "editor.multiCursorModifier": "ctrlCmd" 的情况下，Ctrl+点击会变成多光标而非跳转——这时必须改回 alt 或手动执行命令 Go to Definition（Ctrl+Shift+O）来补救。
悬停提示（Hover）：鼠标停住不点就能看定义摘要，但依赖 provider 返回结构化数据
把鼠标停在符号上几秒出现的弹窗，叫 Hover 提示。它不靠 LSP 的 textDocument/hover 请求就出不来，而且返回值必须是 vscode.Hover 实例，内容得是 MarkedString 或 MarkupContent 格式，纯字符串会被忽略。
使用场景与限制：
- JS/TS 默认显示类型签名 + JSDoc，但只对有完整类型推导的变量生效；
any类型或未声明类型的变量悬停为空 - 自定义插件中若 provider 的
provideHover方法返回undefined或格式错误对象，VSCode 不报错，只是静默不显示 - 悬停内容过长会被截断，建议控制在 3–4 行内，避免用大段代码块
调试技巧：在 hover provider 里加 console.log(position)，配合输出面板的 Log (Extension Host) 查看是否被正确触发。
跳转失败时该查什么：别只盯着快捷键，先看语言服务状态和文档语言模式
跳转失效的根因往往不在按键本身，而在 VSCode 对当前文件的“认知”出了问题。最该优先检查三项：
- 右下角状态栏显示的语言模式是否正确？比如本该是
typescriptreact却显示plaintext，说明文件关联错了，需点击切换或修改files.associations - 打开命令面板（Ctrl+Shift+P），运行
Developer: Toggle Developer Tools，在 Console 里搜definition或hover，看是否有未捕获异常 - 在设置里确认
"editor.gotoLocation.multipleDefinitions"是否设为"goto"（默认值），否则遇到多个定义时会弹选择框而不是直接跳转
复杂点在于：同一个符号在不同语言模式下，LSP 请求参数完全不同。比如 fetch 在 javascript 下指向浏览器 API，在 typescript 下还可能带 node-fetch 类型定义——语言模式切错，跳转目标就彻底偏移。
