Vue项目VS Code无智能提示主因是Vetur与Volar配置错误：Vue 3必须用Volar并禁用Vetur，Vue 2可用Vetur但需配vetur.config.js；还需检查tsconfig.json、shims-vue.d.ts及工作区设置是否干扰语言服务。
Vue 项目在 VS Code 中没有智能提示，大概率不是 Vue 版本或语法问题，而是 Vetur 没装对、没配好，或者和 Volar 冲突了——尤其 Vue 3 项目，Vetur 已不推荐使用，强行启用反而会破坏类型推导和模板补全。
确认你用的是 Vue 2 还是 Vue 3
这是最关键的前置判断。Vue 3（尤其是使用 defineComponent、setup、ref 等组合式 API）必须用 Volar，Vetur 对其支持有限且已停止维护。VS Code 插件市场里搜 “Volar”，装官方插件 Volar（作者：johnsoncodehk），并禁用 Vetur。
- Vue 2 项目（Options API 为主）可继续用
Vetur，但需注意它不支持.vue文件里的 TypeScript 类型精准推导 - 混合项目（Vue 2 + Vue 3 共存）极少见，不建议；若真有，需手动在工作区设置中为不同目录指定语言模式
- 检查方式：
package.json中"vue"的版本号，^3.开头即为 Vue 3
Vue 2 项目配 Vetur：关键配置项不能漏
Vetur 默认开箱即用，但常见提示失效往往是因为没告诉它“哪些文件算 Vue 单文件组件”或“TS/JS 该怎么解析”。需要手动加 vetur.config.js（项目根目录）：
module.exports = {
// 告诉 Vetur 哪些后缀是 .vue 文件（防误判）
extensions: ['.vue'],
// 模板语法高亮与校验规则
template: {
eol: '
',
interpolate: ['{{', '}}']
},
// 脚本语言映射：让 <script lang="ts"> 走 TS 解析器
languages: {
javascript: 'javascript',
typescript: 'typescript',
vue: 'vue'
},
// 格式化用 prettier（如果用了）
format: {
defaultFormatter: {
html: 'prettier',
css: 'prettier',
postcss: 'prettier',
scss: 'prettier',
less: 'prettier',
stylus: 'stylus',
js: 'prettier',
ts: 'prettier'
}
}
}
- 必须重启 VS Code 或重新打开文件夹，配置才生效
- 如果用了
eslint-plugin-vue，确保vetur.validation.template设为true（默认开启） - 若
script块中 import 提示缺失，检查是否启用了"vetur.experimental.templateInterpolationService": true
Vue 3 项目必须关掉 Vetur，启用 Volar
VS Code 安装 Volar 后，默认会在 .vue 文件中接管语言服务。但常见问题包括：
立即学习“前端免费学习笔记（深入）”；
- 右下角状态栏显示 “Vue (Volar)” —— 正常；若仍显示 “Vue (Vetur)”，说明 Vetur 没被禁用：进 VS Code 设置 → 搜索 “vetur” → 取消勾选 “Enable”
- TS 类型提示不生效？检查
tsconfig.json是否包含"include": ["src/**/*"]，且没把.vue文件排除在外 - 模板中
ref或props无提示？确认组件用了defineComponent包裹，或使用defineProps/defineEmits编译宏 - 如果项目含
shims-vue.d.ts，确保它导出declare module '*.vue'，否则 TS 不识别.vue为模块
智能提示失效的隐藏原因：工作区设置覆盖了全局
很多人在用户设置里开了 Volar，却在某个 Vue 项目文件夹的 .vscode/settings.json 里写了：
{
"emeraldwalk.runonsave": {
"commands": [
{
"match": "\.vue$",
"cmd": "echo 'ignored'"
}
]
}
}
这类看似无关的配置可能间接禁用语言服务器。更常见的干扰项是：
-
"javascript.suggestionActions.enabled": false—— 关闭整个 JS 补全 -
"editor.quickSuggestions": { "other": false }—— 模板字符串、注释等场景无提示 -
"vetur.format.enable": false和"volar.format.enable": false虽影响格式化，但某些旧版 Volar 会连带抑制语义提示
建议删掉项目级 .vscode/settings.json 中所有和语言服务、格式化、提示相关的键，只保留真正必要的构建或调试配置。
