Vue项目VSCode保存格式错乱、v-model无提示、defineProps不自动导入、Ctrl+.无响应，根本原因是Volar未真正接管语言服务，ESLint与Prettier权限冲突，且tsconfig.json缺失或配置错误；需确保右下角显示vue模式、启用Volar接管、禁用Vetur、显式配置eslint.validate包含"vue"、关闭eslint.format.enable、设置prettier为默认formatter，并开启autoImports和模板插值服务。
Vue 项目在 VSCode 里保存后格式错乱、v-model 参数没提示、defineProps 不自动导入、Ctrl+. 没反应——不是插件装得少，而是 Volar 没真正接管，ESLint 和 Prettier 权限没划清，且关键配置项被忽略或写错。
为什么 editor.codeActionsOnSave 对 .vue 文件无效
根本卡点在语言服务链路断开，不是配置没加，而是加了也白加。
- 右下角状态栏必须显示
vue（不是HTML或Plain Text），否则 VSCode 根本不把文件交给 Volar 或 ESLint 处理 -
eslint.validate必须显式包含"vue"，且顺序无关紧要，但漏掉就失效：["vue", "javascript", "typescript"] - 必须禁用已废弃的
eslint.autoFixOnSave（VSCode 1.89+ 已移除），改用"editor.codeActionsOnSave": { "source.fixAll.eslint": true } - ESLint 插件必须使用本地安装版本：全局安装的
eslint不会被识别，node_modules/.bin/eslint才是唯一有效路径
为什么 defineProps、ref 不自动 import，Ctrl+. 无响应
这是 TypeScript 语言服务没看到 <script setup> 内容的典型表现，Volar 没接管 TS Server 是主因。
- 必须卸载或禁用
Vetur：它和 Volar 冲突，会导致语言模式识别错乱、类型推导退化为any - 运行命令
Volar: Take Over and Restart（Cmd+Shift+P / Ctrl+Shift+P），强制 Volar 接管 TS/JS 语言服务 - 项目根目录必须存在
tsconfig.json，哪怕只有空对象{}；否则 TS Server 启动失败，所有类型推导失效 - 开启两个开关：
"typescript.suggest.autoImports": true和"javascript.suggest.autoImports": true - 若用了别名路径（如
@/components），tsconfig.json中compilerOptions.paths必须正确定义，否则路径补全和 import 推导都会失败
为什么保存时 Prettier 和 ESLint 反复互相覆盖
冲突本质是两者都在改同一段代码：Prettier 动缩进和引号，ESLint 紧跟着删分号或加空格，再保存又触发 Prettier 回滚——光标跳、波浪线闪、文件变“脏”。
Vue Composition Analyzer
下载
分析 Vue 3 Composition API 使用情况——审计响应式模式、可组合函数设计、ref 与 reactive 的选择、计算属性、watcher 使用及组件……
立即学习“前端免费学习笔记（深入）”；
- 彻底关闭 ESLint 的格式化权：
"eslint.format.enable": false（必须写在工作区.vscode/settings.json，用户级设置会被覆盖） -
.prettierrc里明确写死团队规则，例如："semi": false、"singleQuote": true、"tabWidth": 2 - 确保
editor.defaultFormatter设为"esbenp.prettier-vscode"，且editor.formatOnSave仅作为兜底，不与 ESLint 修复并行启用 - ESLint 只负责检查和修复逻辑/结构问题（如
no-unused-vars、vue/valid-v-if），格式类规则（如缩进、逗号）全部交给 Prettier
为什么 template 中 ref 变量没类型提示、组件跳转失败
这不是插件没装，而是 Volar 模板层校验没开，或 tsconfig.json 缺关键声明。
- 启用
Volar: Enable Template Interpolation Service（设置中搜索即可勾选） -
tsconfig.json中compilerOptions.types必须包含"vue"："types": ["vue"] - 确认
volar.takeOverMode设为true，否则模板里的{{ count }}无法关联到const count = ref(0) - 检查
files.associations是否设了"*.vue": "vue"，否则语法高亮、Emmet、跳转全失效 - 大型项目可加
"volar.ignoreProjectName": ["node_modules", "dist"]避免启动卡顿
最常被忽略的是 tsconfig.json 存在性与 types: ["vue"] 的组合，以及 Volar: Take Over and Restart 这一步手动触发——这两项不完成，其他所有配置都是空中楼阁。
