Ctrl+点击跳转类型定义失效主因是类型信息缺失或配置错误：tsconfig/jsconfig缺失、变量为any/未初始化、动态访问、多文件夹工作区配置未生效、状态栏语言模式不正确。

Ctrl+点击（Windows/Linux）或 Cmd+点击（macOS）能直接跳转到变量类型定义，但前提是类型信息存在且被 TypeScript 或 JS 语言服务正确解析——不是所有变量都支持，也不是点一下就一定有反应。

为什么 Ctrl+点击变量没跳转到类型？

这不是快捷键失效，而是类型链断了。最常见原因有四个：

• tsconfig.json 或 jsconfig.json 缺失或未生效：TS/JS 项目必须有配置文件，哪怕只写 {"compilerOptions": {"allowJs": true}}
• 变量是 any、unknown 或未初始化（如 let x;），TS 推不出具体类型
• 用了动态访问（如 obj[key]、arr[0].prop）或运行时构造的 key，静态分析无法覆盖
• 工作区含多个文件夹，而 tsconfig.json 只在子目录里，TS 服务没加载到根级

右下角状态栏不显示 TypeScript 或 JavaScript，基本可以确定语言服务根本没跑起来。

Go to Type Definition（F7 / Shift+F2）和 F12 的区别

这两个命令干的事完全不同，混淆就会“跳错”：

• F12（或右键 → Go to Definition）：跳到变量声明/赋值处，比如 const user = new User() 就跳到这行
• Shift+F2（Windows/Linux）或 Ctrl+Shift+O（macOS）：跳到该值的「类型描述」——user 是 User 类实例，就跳到 class User 的 constructor 行；如果是字符串字面量，会跳到内置 string 声明
• 光标在函数调用上按 Shift+F2，跳的是它的返回类型定义，不是函数体本身

别指望它跳到 interface User ——除非这个 interface 真正被用作变量类型（比如 const u: User = {...}），否则语言服务不会把它当作“该变量的类型”。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

JavaScript 项目怎么让类型跳转生效？

JS 默认类型能力极弱，得手动补足三层信息：

• 加 // @ts-check 到文件顶部，启用类型检查
• 配 jsconfig.json（不能用 tsconfig.json），内容至少包含：

  {"compilerOptions": {"allowJs": true,"checkJs": true},"include": ["**/*.js"]}

• 关键变量补 @type JSDoc，路径要对——相对路径以 jsconfig.json 所在目录为基准，例如：

  /** @type {import('./api').User} */ const user = fetchUser();

@typedef 和 @type 写错一个字符，或者引用路径不存在，类型链就断了，Ctrl+点击照样没反应。

类型跳转失败时先看什么？

别急着重装插件或改快捷键，先做三件事：

• 右下角状态栏确认语言模式是 JavaScript 或 TypeScript，不是 Plain Text
• 按 Ctrl+Shift+P 运行 TypeScript: Restart TS Server，强制刷新服务
• 打开开发者工具（Ctrl+Shift+P → Developer: Toggle Developer Tools），切到 Console，搜 Failed to start language server 或 error

真正卡住的往往不是语法，而是配置分散：jsconfig 放错目录、node_modules 缺 @types/xxx、某个 export type 被条件编译剔除了——这些地方不报错，但类型链就是连不上。