跨层级跳转需区分“当前文件内”“同工作区不同文件”“多根工作区之间”三类场景；失效主因是语言服务未索引目标文件，而非快捷键问题。
跨层级跳转不是靠“多按几次快捷键”，而是靠明确区分“当前文件内”“同工作区不同文件”“多根工作区之间”这三类场景，每类对应不同的机制和失效点。
Ctrl+Click 跳不到深层嵌套的导入目标？检查路径映射是否生效
比如 import { api } from '@core/api' 点不动，不是跳转功能坏了，是 VSCode 不知道 @core 指向哪。它只认 tsconfig.json 或 jsconfig.json 里的 compilerOptions.baseUrl 和 paths，不读 Webpack/Vite 的 resolve.alias。
- 确认项目根目录下有
tsconfig.json（TS）或jsconfig.json（JS），且没被exclude掉当前路径 -
paths必须用数组：写成"@core/*": ["src/core/*"]，不能写成"@core/*": "src/core/*"（后者会被忽略） - 如果用了 monorepo 工具（如 pnpm workspaces），确保
baseUrl是"."，而不是硬写成"./packages/my-app" - 改完配置后，重启语言服务：命令面板执行
Developer: Restart Language Server
想从 A.ts 跳进 node_modules/@scope/lib/B.ts，但卡在 .d.ts 声明文件？手动切实现
TypeScript 默认跳转到类型定义（.d.ts），尤其当包里带了声明文件时。你看到的是 node_modules/@scope/lib/index.d.ts，但真正想看的是 src/ 下的源码。
- 光标停在符号上，按
Ctrl+Shift+Click（Windows/Linux）或Cmd+Shift+Click（macOS），会弹出菜单，选 “Go to Implementation” - 如果没菜单，说明语言服务没识别出实现——检查包是否有
"types": "dist/index.d.ts"但没导出"main"或"module"字段 - 临时方案：在
node_modules/@scope/lib里手动打开package.json，看main指向哪个文件，再用Ctrl+P输入路径跳过去
多根工作区下，跨文件夹跳转失败？别依赖全局索引
VSCode 在多根工作区中默认把每个根目录当作独立项目处理。你在 client/ 里写的 import { utils } from 'shared'，如果 shared/ 是另一个根目录，但没被正确识别为可解析路径，跳转会静默失败。
- 确保所有根目录都已添加进工作区（不是仅放在同一父文件夹下）：右键资源管理器 → “Add Folder to Workspace…”
- 检查每个根目录下的
tsconfig.json是否有"references"或正确的"include"，否则语言服务不会跨根索引 - 避免在
client/tsconfig.json里写"paths": { "shared/*": ["../shared/*"] }—— 相对路径在多根模式下不可靠，应统一用baseUrl: "."+ 符号路径 - 跳转前先确认右下角语言模式显示的是 JavaScript (ES6) 或 TypeScript，不是 Plain Text；否则整个语义分析链就断了
最常被忽略的一点：跨层级跳转的可靠性，90% 取决于语言服务是否真正“看到”了目标文件。不是快捷键问题，也不是插件没装，而是 VSCode 根本没把它纳入索引范围——所以永远先看 Console 里有没有 No client for file:// 或 Failed to load configuration 这类报错。
