VSCode跳转@/别名必须依赖项目根目录下的jsconfig.json（JS项目）或tsconfig.json（TS项目），且需正确配置compilerOptions.baseUrl为"."和paths为"@/": ["src/"]，否则跳转失效。
jsconfig.json 或 tsconfig.json 必须存在且位置正确
VSCode 跳转 @/components/Button 这类别名，根本不管 webpack.config.js 里怎么配的 resolve.alias。它只认项目根目录下的 jsconfig.json（纯 JS 项目）或 tsconfig.json（TS 项目），且该文件必须被 VSCode 实际加载——右下角 TypeScript 版本旁显示的路径就是当前生效的配置文件路径。
常见错误现象：Ctrl+Click 跳转到 node_modules/@/components/Button，说明 VSCode 根本没读到你的别名配置。
-
jsconfig.json必须放在和package.json同级的项目根目录，不能叫jsconfig.js或.jsconfig.json - TS 项目若存在多个
tsconfig.json（如tsconfig.test.json），确保你改的是 VSCode 当前加载的那个 - 如果项目用的是 Vite 或 Vue CLI，默认不生成
jsconfig.json，得手动创建
baseUrl 和 paths 配置要严格匹配语义
baseUrl 不是 Webpack 的 path.resolve(__dirname, 'src')，它是静态字符串，表示所有 paths 的基准路径；paths 的 value 必须是相对于 baseUrl 的数组，且结尾带 /* 才能匹配子路径。
例如 Vue CLI 默认结构中，src 是源码根目录，jsconfig.json 应这样写：
PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。
立即学习“前端免费学习笔记（深入）”；
{
"compilerOptions": {
"baseUrl": ".",
"paths": {
"@/*": ["src/*"],
"@components/*": ["src/components/*"]
}
},
"include": ["**/*.js", "**/*.jsx", "**/*.ts", "**/*.tsx"],
"exclude": ["node_modules"]
}
-
baseUrl设为"."表示以jsconfig.json所在目录（即项目根）为起点 -
"@/*": ["src/*"]中的src/*是相对./的路径，不是相对当前文件的路径 - 别名 key 支持通配符
*，但 value 里每个字符串都必须是数组元素，哪怕只有一个 - 如果
baseUrl设成"src"，那"@/*": ["./components/*"]就错了——应该写成"@/*": ["components/*"]
改完配置后 TS Server 必须重启
VSCode 不会自动重载 jsconfig.json 或 tsconfig.json 的路径映射。保存文件后跳转仍无效，不是配置错了，而是语言服务缓存没刷新。
- 快捷键
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输入TypeScript: Restart TS server并回车 - 或者直接关闭整个文件夹，再通过
File → Open Folder…重新打开项目根目录 - 仅关闭/重开单个文件无效，TS 服务是进程级缓存
- 验证是否生效：在任意
import行上Ctrl+Click，看是否跳转到正确文件；同时运行tsc --noEmit，如果报Cannot find module '@/xxx'，说明配置本身就有问题
插件只是辅助，别依赖它绕过基础配置
像 Path Intellisense、alias-skip 这类插件确实能补全或跳转，但它们不参与 TypeScript 类型检查，也不影响重构（比如重命名组件时，插件不会帮你改所有 @/ 引用）。真正可靠的路径支持，必须靠 jsconfig.json / tsconfig.json + TS Server。
-
Path Intellisense主要解决路径补全，对跳转帮助有限；alias-skip可自定义映射，但需手动维护，且不联动 webpack 别名 - 如果 webpack 的
resolve.alias和jsconfig.json不一致，会出现「代码能跑，但点不开」或「点开是错文件」——这是静默错误，调试时极难发现 - 多人协作项目中，把
jsconfig.json提交到 Git，比让每个人都装插件、配映射更可靠
最易被忽略的一点：路径别名生效的前提是文件本身被 TypeScript 语言服务识别，也就是 include 字段要覆盖到你的源码目录，否则即使配置全对，也跳不动。
