volar在vue3项目中不生效主因是未成功接管.vue文件或ts语言服务，需手动启用take over模式、禁用内置ts插件、正确配置文件关联、关闭skiplibcheck并确保defineprops存在以触发vue sfc模式。

Volar 在 Vue 3 项目里不生效，基本就是被 Vetur 抢了控制权，或者 TypeScript 语言服务没交出去——不是插件没装对，是接管没成功。

为什么装了 Volar 还是没 defineProps 提示？

最常见原因是 VSCode 仍在用内置 TypeScript 插件或 Vetur 处理 .vue 文件，defineProps 根本没进 Vue SFC 模式。

• 打开命令面板（Ctrl+Shift+P 或 Cmd+Shift+P），运行 Volar: Switch to Take Over Mode —— 这步必须手动触发，不是装完就自动启用
• 禁用 VSCode 内置的 TypeScript and JavaScript Language Features：在扩展面板搜 @builtin typescript，右键 → Disable (Workspace)
• 确认右下角语言模式是干净的 Vue（不是 Vue (Vetur)、Vue HTML 或 HTML）；点它 → Configure File Association for '.vue' → 输入 vue 回车，再手动切一次
• 重启窗口（Developer: Reload Window），不是重载扩展

ref() 类型推导全是 any？检查 tsconfig.json 的 skipLibCheck

Volar 依赖 TypeScript 加载 @vue/runtime-core 类型定义，skipLibCheck: true 会直接跳过它们。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 打开项目根目录的 tsconfig.json，找到 compilerOptions
• 确保 "skipLibCheck": false（Vue 3.3+ 官方推荐设为 false）
• 如果用了 "extends"（比如 "./tsconfig.base.json"），得去被继承的文件里改，只改当前文件无效
• 改完保存，等右下角提示 TypeScript 已重新加载，再看 ref<string>()</string> 是否恢复类型

为什么 <script setup></script> 里组件名不补全？

Volar 默认不索引 defineComponent 或 defineAsyncComponent 注册的组件名，需要显式开启解析开关。

• 在项目根目录建 volar.server.config.json（注意名字不能错，不是 volar.config.json）
• 内容写成：

  {"experimentalResolveType": true}

• 保存后，按 Ctrl+Shift+P 运行 Volar: Restart Server，不会自动热更
• 确保 <script setup lang="ts"></script> 顶部有 defineProps 或 defineEmits（哪怕空对象），否则 Volar 不认为这是 Vue SFC 脚本块

真正卡住人的地方，往往不是配置项漏写了，而是改完没重启服务器、没重载窗口、或者文件名/路径/JSON 格式有一处不对——Volar 对这些极其敏感，且几乎不报错，只静默失效。

前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！