Vue Peek能跳转需满足三个前提：插件已安装、.vue文件语言模式为Vue、组件标签名可被静态解析；常见失效原因包括语言模式错误、kebab-case未加引号、动态注册组件及缺失jsconfig.json路径映射。
Vue Peek 能跳转，但必须满足三个前提：插件已安装、.vue 文件语言模式为 Vue、组件标签名可被静态解析（不能是动态拼接或运行时注册）。
Vue Peek 安装后不生效的常见原因
装了插件却点不动，大概率卡在这几个环节：
- VSCode 把
.vue文件识别成了HTML或Plain Text模式——右下角状态栏点击语言模式，手动选成Vue - 组件名用了 kebab-case 但没用引号包裹，比如
<user-card></user-card>在模板中未加引号，Vue Peek 无法识别为合法自定义元素 - 组件是通过
defineAsyncComponent或resolveComponent动态注册的，Vue Peek 不处理运行时逻辑，只解析静态 import / components 选项 - 项目根目录没有
jsconfig.json或tsconfig.json，导致别名（如@/components/xxx）路径无法映射，跳转落空
确保 .vue 文件语言模式正确
这是最容易被忽略的基础条件。VSCode 默认可能把新创建的 .vue 文件当成 HTML 处理，导致模板区域完全无语义支持：
- 打开任意
.vue文件，看右下角状态栏显示的语言名称（如 “HTML”、“Plain Text”） - 点击它，在弹出菜单中选择
Vue（不是 “Vue HTML” 或 “Vue (Volar)”） - 若列表里没有
Vue，说明缺少基础 Vue 支持插件，需先安装Volar（非 Vetur） - 为避免每次手动切，可在工作区设置中加一行：
"files.associations": {"*.vue": "vue"}
配置 jsconfig.json 支持别名跳转
用了 @/components/UserCard 这类写法却跳不到文件？问题几乎一定出在路径映射缺失：
vue-composition-api-best-practices
下载
Vue 3 组合式 API 与 最佳实践，涵盖代码组织、useXxx 模式、组合式函数设计、Store 集成、响应式优化及功能抽取。
立即学习“前端免费学习笔记（深入）”；
- 在项目根目录新建
jsconfig.json（TypeScript 项目用tsconfig.json即可） - 写入至少这两项：
"baseUrl": "."和"paths": {"@/*": ["src/*"]} - 注意：
paths的 value 必须是数组，且路径要以/*结尾；如果组件在src/views下，也得单独加一条"@/views/*": ["src/views/*"] - 改完保存，**必须关闭并重新打开整个 VSCode 窗口**（仅重启服务或重载窗口不够）
Vue Peek 的实际使用限制
它不是万能跳转器，明确知道它“不做什么”，比知道它“能做什么”更重要：
- 不支持从
setup()里的defineComponent({ components: { UserCard } })中跳转——这种写法 Vue Peek 看不见 - 不解析
v-for中的动态组件名，例如<component :is="compName"></component>无法跳转 - 不处理
import * as comps from '@/components'后再解构使用的场景 - 如果组件定义文件是
index.ts或index.js，必须确保导出是具名导出（export { UserCard }）或默认导出（export default UserCard），且文件名和组件名一致
真正卡住跳转的，往往不是插件没装，而是语言模式错、路径没映射、或者你正试图跳转一个 Vue Peek 根本不认的写法。先确认这三点，比反复重装插件管用得多。
