VSCode不运行Vue 3项目,仅提供编辑支持;运行依赖Vite/Vue CLI,Volar负责语言服务。defineProps报错主因是未正确启用Vue语言模式、未开启Take Over、缺少tsconfig.json或残留Vetur配置。

VSCode 本身不运行 Vue 3 项目,它只负责编辑和语言支持;真正运行靠的是 Vite / Vue CLI 启动的开发服务器。Volar 插件不参与运行,但决定你能不能看清代码、跳转对、类型不报错——配错一步,defineProps 就红得刺眼,不是项目错了,是你没“告诉” VSCode 这是个 Vue 文件。
为什么装了 Volar 还是 defineProps 报错
这不是编译错误,是 VSCode 没启用 Vue 语言服务。常见原因有:
- 右下角语言模式显示的是
HTML或Vue HTML,不是纯Vue—— 点击它,手动选Vue(不是带括号的“Vue (Volar)”) -
volar.enable被关了:在设置里搜这个选项,确保它是true - 项目根目录没有
tsconfig.json或jsconfig.json,Volar 启动时降级为“仅 HTML 模式”,<script setup> 直接被当普通 TS 处理</script> - 用了 pnpm/yarn pnp,Volar 找不到
@vue/language-core:执行pnpm add -D @vue/language-core(即使不用它写代码)
如何确认 Volar 真正接管了 TypeScript
Volar 的核心能力(比如 ref 自动解包、模板内变量类型提示)依赖它“接管” TS 语言服务。只装插件不够,必须显式启用 Take Over:
- 按
Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(Mac),输入Vue: Take Over and Restart并回车 - 等待几秒,右下角状态栏应显示
Volar (Take Over),而不是TypeScript或空白 - 如果没出现,检查是否禁用了内置 TS 插件:在设置里搜
typescript.suggest.autoImports,取消勾选;再执行命令Volar: Disable TS Plugin - 重启窗口:
Ctrl+Shift+P→Developer: Reload Window
语法高亮失效的三个硬性条件
高亮不是“开了就亮”,它需要三者同时满足:
-
files.associations配置正确:在.vscode/settings.json中加这一行:"*.vue": "vue" -
typescript.tsdk指向项目本地 TS:在.vscode/settings.json中写"typescript.tsdk": "./node_modules/typescript/lib",否则defineProps()里的泛型根本不会解析 - 禁用所有 Vetur 相关配置:不仅禁用扩展,还要在设置里搜
vetur,把vetur.validation.*和vetur.format.*全部设为false;残留的vetur.experimental.*也会干扰
模板内表达式不着色?那是实验功能没开
里的 {{ count + 1 }} 不高亮运算符、也不提示 count 类型?这不是 bug,是 Volar 默认关闭了模板插值服务:
- 在 VSCode 设置里搜
volar interpolation - 勾选
Volar > Experimental: Template Interpolation Service - 或者直接在
.vscode/settings.json加:"volar.experimental.templateInterpolationService": true - 注意:该功能依赖
Take Over已启用,且项目有正确的tsconfig.json,否则开了也无效
最容易被忽略的其实是语言模式切换这一步——插件装了、配置写了、TS 也接管了,但右下角没点成 Vue,整个文件就还是“裸 HTML”,连 <script setup></script> 都不会触发语法解析。别信自动识别,手动点一次最稳。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











