VSCode TypeScript路径别名跳转失效，90%因tsconfig.json未同时配置baseUrl和paths或未重启TS服务；二者必须配对，baseUrl设为"."且文件置于项目根目录，paths的key需含"*"、value为以baseUrl为起点的数组，改后须执行“TypeScript: Restart TS Server”并验证tsc --noEmit无错。
VSCode 里 TypeScript 路径别名跳转失效，90% 是 tsconfig.json 配置不完整或没重载 TS 服务，不是 Webpack/Vite 配置的问题。
tsconfig.json 必须同时配 baseUrl 和 paths
只写 paths 不设 baseUrl，或者 baseUrl 设成 "./" 却把 tsconfig.json 放在子目录（比如 src/tsconfig.json），VSCode 就完全 ignore 别名。TS 编译器要求二者必须配对生效。
-
baseUrl是相对于tsconfig.json所在目录的路径，通常就是"."（项目根目录） -
paths的 key 是匹配模式（如"@/*"），value 是字符串数组，每个路径必须以baseUrl为起点，且结尾带/*（例如["src/*"]，不能写成["src"]） - 如果项目有多个
tsconfig.json（如tsconfig.json、tsconfig.test.json），VSCode 默认加载的是最外层那个——右下角 TypeScript 版本旁显示的路径就是它
改完配置后必须重启 TS 语言服务
保存 tsconfig.json 后 Ctrl+Click 依然无效？这是正常现象。VSCode 的 TS 服务不会自动重读路径映射，进程级缓存需要手动刷新。
- 快捷键
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输入TypeScript: Restart TS Server并回车 - 或者直接关闭整个文件夹，再通过
File → Open Folder…重新打开项目根目录 - 不要只关/重开单个文件——TS 服务不感知单文件变更，只响应工作区级重载
先验证 tsc --noEmit 是否报错
VSCode 的跳转能力底层复用 TypeScript 编译器的模块解析逻辑。如果命令行跑 tsc --noEmit 都报 “Cannot find module '@utils/date'”，那 VSCode 肯定也跳不了。
- 在终端执行
tsc --noEmit，检查是否输出路径解析错误 - 常见报错：
error TS2307: Cannot find module '@/*' or its corresponding type declarations.——说明baseUrl或paths格式不对，或路径不存在 - 确保
paths中的路径实际存在（比如["src/utils/*"]对应的src/utils/目录得真实存在）
Vite/Webpack 等构建工具别名要和 tsconfig.json 保持一致
构建能跑通 ≠ VSCode 能跳转。Webpack 的 resolve.alias 或 Vite 的 resolve.alias 只影响打包，不影响编辑器跳转。VSCode 只认 tsconfig.json（TS 项目）或 jsconfig.json（JS 项目）里的 baseUrl + paths。
- Vite 项目：除了
vite.config.ts里配resolve.alias，tsconfig.json也得同步写baseUrl和paths - 纯 JS 项目：新建
jsconfig.json（不是jsconfig.js），内容结构同tsconfig.json，但需加"checkJs": true - Vue 3 + TS 项目常见坑：
tsconfig.app.json里写了paths，但 VSCode 加载的是根目录的tsconfig.json，导致配置被忽略
最容易被忽略的是：路径别名生效的前提是 TypeScript 编译器自己能解析它，而 VSCode 只是调用了这个能力。别在 Webpack 配置里反复折腾，先让 tsc --noEmit 静默通过，再重启 TS Server，跳转基本就稳了。
