VSCode无法跳转TypeScript定义，90%是TS语言服务未加载项目配置：需确保根目录有tsconfig.json（哪怕仅{}）、paths与baseUrl配置正确、执行“TypeScript: Restart TS server”刷新缓存。
VSCode 无法跳转到 TypeScript 定义，90% 的情况不是插件坏了，而是 TypeScript 语言服务压根没加载你的项目配置。
tsconfig.json 缺失或路径不对
TS 语言服务必须读到 tsconfig.json 才能解析模块、别名和类型。没有它，VSCode 只会把当前打开的文件当“散装文本”处理，跳转退化为字符串匹配——基本不可靠。
- 新建空项目时，哪怕内容只是
{}，也必须有tsconfig.json（放在项目根目录） - monorepo 中子包如果单独打开，
tsconfig.json必须在该子包目录下，不能只靠上层根目录的配置 - 确认 VSCode 当前工作区是项目根目录：右下角状态栏应显示
TypeScript 5.x.x，而不是Plain Text或JavaScript - 如果用了
pnpm workspace或lerna，检查是否误开了父目录而非具体 package 目录
paths 和 baseUrl 配置无效
写了 @/utils 却点不动？不是 Webpack/Vite 的 resolve.alias 没生效，是 TS 语言服务根本没读到你的路径映射。
-
baseUrl必须是相对路径，写"."，不能写""或"./" -
paths的 key 和 value 都必须带通配符*，例如"@/*": ["src/*"]，写成"@/utils": ["src/utils"]不生效 - 确保
compilerOptions.moduleResolution是"node"（TS 默认值，但显式声明更稳） - 改完
tsconfig.json后，必须手动执行Ctrl+Shift+P → TypeScript: Restart TS server，否则缓存不更新
跳转到了 .d.ts 而不是 src 实现
这不是 bug，是 TypeScript 的默认行为：F12 优先跳类型声明。尤其当你 import 的是第三方库（比如 lodash-es），它直接停在 node_modules/@types/lodash-es/index.d.ts。
- 想直奔源码？按住
Ctrl（Win/Linux）或Cmd（macOS）再悬停函数名，看浮层里有没有 “Go to Source Definition” 链接 - 确保
typescript.preferences.includePackageJsonAutoImports设为"auto"或"explicit"，否则语言服务不会索引node_modules中的类型定义链 - 自己写的包如果导出了
types字段，且没同时提供source字段，TS 就找不到实现 —— 这时候得靠package.json的exports或typesVersions控制解析优先级
语言服务根本没启动
状态栏没报错，但 Ctrl+Click 没反应，大概率是语言服务卡在启动阶段，或者被其他扩展干扰了。
- 打开
Developer: Toggle Developer Tools，切到 Console 标签页，搜Failed to start或LanguageClient is not ready - 常见冲突：同时启用 Vetur 和 Volar；或多个 Python 扩展共存（如 Pylance + Python 官方扩展但没设
python.languageServer） - 临时禁用所有扩展，只留 TypeScript 插件，再测试；确认有效后逐个启用，定位冲突源
- 检查
Output面板里的TypeScript Server日志，看是否提示Cannot read property 'map' of undefined—— 这通常是tsconfig.json语法错误（比如多了一个逗号）
最常被忽略的其实是「当前文件是否被 TS 服务接管」：哪怕 tsconfig.json 写对了，如果文件后缀是 .js 且没开 allowJs: true，或者没在 include 列表里，它就只是个普通 JS 文件，TS 服务压根不碰它。
