确认Volar真正接管.vue文件需三步：右下角语言模式手动切为Vue（非Vue HTML或Vetur）、禁用内置TS插件和Vetur、控制台搜volar见Registering Vue language features日志。
装对插件、关掉冲突项、手动切语言模式，三步做完就能高亮+类型提示；缺一步，defineProps就报红，ref就不自动解包。
怎么确认 Volar 真正接管了 .vue 文件
VSCode 装了 Volar 不等于它就在干活——它可能还在用 HTML 模式或 Vetur 模式打开 .vue 文件，此时右下角显示的是 HTML、Vue (Vetur) 或 Plain Text，而不是干净的 Vue。
- 打开任意
.vue文件，点击右下角语言模式标签（比如当前显示HTML） - 选
Configure File Association for '.vue'→ 输入vue回车（不要选Vue (Volar)或Vue HTML） - 再点一次语言模式，手动切换成
Vue - 按
Ctrl+Shift+P运行Developer: Toggle Developer Tools，在 Console 里搜volar，看到Registering Vue language features才算真正激活
为什么 defineProps 一直报 Cannot find name 'defineProps'
这不是代码写错了，是 Volar 没进 Vue SFC 模式——常见原因有三个：TypeScript 插件没让位、项目没配 tsconfig.json、或者 <script setup> 缺少“触发器”。
- 禁用 VSCode 内置的
TypeScript and JavaScript Language Features：命令面板搜built→ 找到该扩展 →Disable (Workspace)→ 重启窗口 - 确保项目根目录有
tsconfig.json（哪怕空文件也行），且没在exclude里把src/**/*.vue排除掉 -
<script setup lang="ts">里必须显式调用defineProps或defineEmits，哪怕空对象：const props = defineProps<{}>()—— 这是告诉 Volar “这是 Vue 文件，不是普通 TS”
要不要开 Take Over Mode？怎么开才有效
不开 Take Over Mode，Volar 就只做语法高亮和基础跳转，ref 不解包、<template> 里变量无提示、defineProps 泛型不生效——所有类型能力都残废。
Ainative Vue Sdk
下载
使用 `@ainative/vue-sdk` 为 Vue 3 应用添加 AI 聊天功能。适用于以下场景：(1) 安装 `@ainative/vue-sdk`，(2) 在 Vue 组件中使用 `useChat` 组合式函数，(3) 提供……
立即学习“前端免费学习笔记（深入）”；
- 按
Ctrl+Shift+P输入Volar: Switch TS Plugin→ 选Enable - 弹窗提示重启 TS 服务时，必须点确认（不能忽略）
- 重启后状态栏右下角应显示
Volar (Take Over)，不是Vue或Vue (Volar) - 如果开了但无效，直接关掉
Volar > Enable Take Over Mode设置项，再重新执行命令，最后彻底重启 VSCode 窗口（不是重载）
哪些设置必须写进 .vscode/settings.json
全局设置会污染其他项目，Vue 开发必须靠工作区配置精准控制。尤其当项目用 pnpm 或自定义 node_modules 路径时，Volar 可能找不到核心包。
- 新建
.vscode/settings.json，至少包含：{"files.associations": {"*.vue": "vue"}} - 禁用 Vetur 工作区级启用：
"vetur.validation.template": false（即使已禁用插件，这行也能防残留） - 关闭 TypeScript 自动导入干扰：
"typescript.preferences.includePackageJsonAutoImports": "off"，否则import { ref } from 'vue'可能被错误补全成其他包 - 若用 pnpm，建议加一行：
"volar.disableDefaultTypescriptPlugin": true，避免和 pnpm 的链接机制冲突
最常被忽略的是「重启窗口」这一步——Take Over Mode 和文件关联配置都依赖热加载机制，只改配置不重启，等于白配。还有就是 tsconfig.json 必须在项目根目录，不在 src/ 下，也不在子目录里，Volar 只认这一份。
