Volar 类型推导失效主因是 volar.takeOverMode 未启用或残留 vue-template-compiler；需确保 vue ≥3.3、@vue/language-core 已安装、.vue 语言模式为 vue，并配置 baseUrl 和 paths。
Vue 3 项目里 defineProps 没提示、ref 类型是 any、@/components 跳转失败——不是插件没装，是 Volar 没接管或配置卡在关键几处。
为什么 Volar 的类型推导不生效
常见错误现象：props.msg. 按点没补全；const count = ref(0) 鼠标悬停显示 any；defineProps 泛型写法完全没响应。
- 检查
package.json是否残留vue-template-compiler：Volar 看到它会强制降级为兼容模式，直接关掉类型推导 - 确认项目中
vue版本 ≥ 3.3，且已安装最新版@vue/language-core（Volar 依赖它做 TS 类型服务） -
settings.json中必须启用"volar.takeOverMode": true，否则 TypeScript 语言服务仍走原生路径，模板内类型无法穿透 - 确保
.vue文件语言模式设为vue（右下角点击切换），不是html或typescript
Path Intellisense 在 Vue 3 + Vite 里跳转失效
使用场景：写 import { useAuth } from '@/hooks/useAuth'，Ctrl+Click 却跳进 node_modules/@types/xxx 或报“no definition found”。
- 必须配
jsconfig.json或tsconfig.json，含"compilerOptions": { "baseUrl": ".", "paths": { "@/*": ["src/*"] } } - VSCode 设置中关闭原生路径提示：
"javascript.suggest.paths": false和"typescript.suggest.paths": false - Vite 项目建议加
"volar.ignoreProjectWarning": true，避免 Volar 错误拦截路径解析逻辑 - 别名路径补全本身不依赖 Path Intellisense 插件——它只补全字符串，真正跳转靠的是 Volar + TS 配置
Prettier 格式化 .vue 文件后 script/style 块缩进错乱
常见错误现象：保存后 <script setup> 内容被压成一行；<style scoped> 里 CSS 属性换行异常；defineProps 泛型被拆开换行。
Ainative Vue Sdk
下载
使用 `@ainative/vue-sdk` 为 Vue 3 应用添加 AI 聊天功能。适用于以下场景：(1) 安装 `@ainative/vue-sdk`，(2) 在 Vue 组件中使用 `useChat` 组合式函数，(3) 提供……
立即学习“前端免费学习笔记（深入）”；
- 必须安装
@prettier/plugin-vue，并在prettier.config.js中显式启用：plugins: ['@prettier/plugin-vue'] - 启用 Vue 特有缩进：
vueIndentScriptAndStyle: true（默认false） - 禁用 ESLint 的格式化能力：
"eslint.format.enable": false，否则 ESLint 和 Prettier 规则冲突导致反复重排 - TypeScript 类型语法（如
interface、泛型）Prettier 本就不处理——这不是 bug，是设计如此
如何让 .vue 模板里的组件名 Ctrl+Click 直接跳转定义
使用场景：在 <UserProfile /> 上 Ctrl+Click，期望打开 src/components/UserProfile.vue，而不是全局搜索或报错。
- 仅靠 Volar 不够，需搭配
Vue Peek插件（非 Vue VSCode Snippets） -
Vue Peek支持别名路径（@/components/xxx）和相对路径，且不依赖文件名与组件名严格一致 - 禁用
Vetur：它和 Volar 共存时会抢夺.vue文件的语言服务，导致跳转逻辑混乱 - 如果组件是通过
defineAsyncComponent引入的，跳转可能失效——这是当前限制，不是配置问题
最常被忽略的其实是 volar.takeOverMode 和 vue-template-compiler 的共存关系：前者必须开，后者必须删。其他所有智能提示问题，八成卡在这两个点上。
