因为VSCode的TypeScript语言服务不读Webpack或Vite的别名配置，只认jsconfig.json（JS项目）或tsconfig.json（TS项目）里的compilerOptions.baseUrl和paths；没这个文件或配置错误，@/路径就无法跳转、补全或重命名。
为什么@/路径在VSCode里点不了跳转
因为VSCode的TypeScript语言服务不读Webpack或Vite的别名配置，只认jsconfig.json（JS项目）或tsconfig.json（TS项目）里的compilerOptions.baseUrl和paths。没这个文件，或者配错位置、格式，@/components/Hello.vue这种写法就纯靠猜——跳转、补全、重命名全失效。
jsconfig.json必须放对位置且内容精简
它得放在项目根目录（和package.json同级），不能塞进src里，也不能叫tsconfig.json（哪怕你用TS，JS项目也得叫jsconfig.json）。最小可用配置只有三件事：
-
"baseUrl": "."—— 这是关键，让paths里的路径以项目根为起点 -
"@/*": ["src/*"]—— 映射所有@/xxx到src/xxx -
"include": ["src/**/*"]—— 确保语言服务扫描src下文件，不然连import里的普通路径都跳不动
别抄网上带一堆lib、types的冗余配置，Vue CLI或Vite默认结构下，上面三条就够了。
跳转失败的四个高频卡点
配完还是点不动？先盯这几个地方：
Ainative Vue Sdk
下载
使用 `@ainative/vue-sdk` 为 Vue 3 应用添加 AI 聊天功能。适用于以下场景：(1) 安装 `@ainative/vue-sdk`，(2) 在 Vue 组件中使用 `useChat` 组合式函数，(3) 提供……
立即学习“前端免费学习笔记（深入）”；
- 文件名大小写不一致：比如
import Foo from '@/components/foo.vue'，但实际文件是Foo.vue——macOS/Linux直接失败，Windows可能侥幸通过但不可靠 -
jsconfig.json被IDE自动建在子目录（如.vscode/）里，必须挪回根目录 -
<script setup>里用了动态import()：比如defineAsyncComponent(() => import('@/pages/Home.vue'))，VSCode 1.90+仍不支持这种跳转，属于已知限制 -
.vue文件右下角语言模式显示为HTML或Plain Text——必须是Vue，否则模板区根本不会触发语义分析
Volar启用后仍跳不到组件标签怎么办
装了Volar但<UserCard>点不了？除了jsconfig.json，还得开一个开关：
- 在VSCode设置里搜
volar.template.interpolationService，勾选启用 - 确保
compilerOptions.types包含"vue"（tsconfig.json里要有，jsconfig.json可不加） - 如果之前装过Vetur，务必卸载——两者冲突，Volar会静默降级为基本语法高亮
动态导入、嵌套别名（如@/@/utils）、远程开发时路径协议未适配，这些都不是配置能绕过去的硬限制，得换思路处理。
