tsconfig.json 中 baseUrl 和 paths 未生效的最常见原因是 TypeScript 语言服务未读取配置，需确保配置正确、重启 TS Server、检查激活的 tsconfig 路径，并开启 includePackageJsonAutoImports。
tsconfig.json 中的 baseUrl 和 paths 配置没生效
VSCode 路径别名跳转失效，最常见原因是 TypeScript 语言服务压根没读到你的路径映射配置。它不看 Webpack 或 Vite 的 vite.config.ts，只认 tsconfig.json（或 jsconfig.json，如果是纯 JS 项目）。
确保你在项目根目录有 tsconfig.json，且包含类似这样的配置：
{
"compilerOptions": {
"baseUrl": ".",
"paths": {
"@/*": ["src/*"],
"@components/*": ["src/components/*"]
}
}
}
注意：baseUrl 必须是相对路径（如 "."），不能是 "./" 或 ""；paths 的 key 必须带通配符 *，value 也必须对应带 *，否则 TS 不识别。
- 如果用的是 JS 项目，改用
jsconfig.json，结构完全一致 - 修改后必须重启 TS Server：按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Restart TS server并执行 - 检查右下角状态栏是否显示 “TypeScript 5.x.x” —— 如果显示 “JavaScript”，说明当前文件没被 TS 服务接管，可能因为文件后缀是
.js但没启用allowJs，或没在include列表里
VSCode 没启用 typescript.preferences.includePackageJsonAutoImports
即使 tsconfig.json 正确，导入 npm 包时别名仍无法跳转（比如 import { foo } from 'lodash-es' 点不了），大概率是这个设置被关了。VSCode 默认关闭自动索引 node_modules 中的类型定义，导致跳转链断裂。
打开设置（Ctrl+, ），搜索 includePackageJsonAutoImports，设为 auto 或 explicit。更直接的方式是编辑 settings.json：
"typescript.preferences.includePackageJsonAutoImports": "auto"
这个选项影响所有基于 TS 语言服务的跳转行为，包括从 import 语句跳进第三方包源码（前提是包自带 types 或有 @types/xxx）。
-
"auto"：只要package.json里声明了依赖，就尝试自动补全和跳转 -
"explicit"：仅对import语句中显式写出的包生效 - 设为
off会导致几乎所有第三方库跳转失效，且无提示
工作区启用了多根工作区（Multi-root Workspace），但 tsconfig.json 不在根文件夹
如果你用的是代码工作区（.code-workspace），并且项目文件夹不是工作区的“第一个根”，VSCode 可能默认加载错 tsconfig.json。TS Server 会优先找最外层根目录下的配置，而不是你当前打开的子文件夹里的。
解决方法很简单：在 VSCode 窗口右下角点击 TypeScript 版本号旁的文件夹图标，确认当前激活的 TS 配置路径是否指向你期望的 tsconfig.json。如果不是，点击切换，手动选中正确的配置文件。
- 多根工作区下，每个文件夹可有自己的
tsconfig.json，但 VSCode 默认只用一个 —— 它不会自动为每个根分别启动 TS Server - 如果子项目需要独立配置，建议单独开窗口，或使用
"typeAcquisition": { "enable": true }配合jsconfig.json降级处理 - 别依赖
extends跨目录引用父级tsconfig.json，路径解析容易出错，尤其在不同操作系统上
别名跳转到了声明文件（.d.ts），但你想跳到实现文件（.ts/.js）
这是正常现象，不是 bug。TS Server 默认优先跳转到类型声明（.d.ts），因为它是类型检查的依据。比如你装了 @types/react，点 React.useState 就会停在 node_modules/@types/react/index.d.ts，而不是 react/cjs/react.development.js。
想强制跳到实现，有两个办法：
- 按住
Ctrl（或Cmd）再鼠标悬停，会出现“Go to Implementation”（而非“Go to Definition”）选项，快捷键通常是Ctrl+F12 - 在设置里开启
"javascript.suggest.autoImports": false（JS 项目）或确保"typescript.preferences.useAliasesForRenames": true，这能让重命名和跳转行为更贴近实际模块结构 - 某些库（如 Vue 3）导出的是包装后的对象，TS 声明里没有具体实现，此时“Go to Implementation”也会空白 —— 这说明确实没提供可跳的源码，不是配置问题
路径别名本身不决定跳转目标，它只解决“从哪开始解析字符串”。最终跳到哪儿，取决于类型声明是否完整、TS Server 是否索引到位、以及你用的是 Definition 还是 Implementation。这点容易被当成配置失败，其实只是预期和机制不匹配。
