Vue2项目中Vetur重构需严格限定范围：全局替换须设*.vue过滤，F2重命名仅限<script>块内，灯泡提示依赖ESLint与Vetur双重验证，Extract功能基本不可用，手动拆分更可靠。
Ctrl+Shift+H 做全局替换前必须限定范围
Vue2 项目里大量使用 v-bind:、v-on:、v-model.sync 等指令，批量替换成缩写（如 :、@、v-model）是常见需求，但直接 Ctrl+Shift+H 全局扫容易出错。
- 务必在 Include files 输入框填
**/*.vue，避免误改.js或.ts中的字符串字面量 - 正则启用时，
v-bind:(\w+)→:$1是安全的，但要勾选.*图标并逐条预览——尤其注意是否匹配到了v-bind:style="{...}"里的内部内容 - 改完立刻执行
git diff --no-index或至少看一眼变更列表，重点检查<template>是否出现未闭合标签或属性值被截断 - 不要跳过本地运行
npm run serve验证：某些模板表达式里嵌套了v-bind:（比如<div v-bind:[key]="val">），这类动态绑定不能简单替换
F2 重命名只在 <script> 区生效，且依赖 Vetur 正确识别
你在 <script> 里定义了一个 data() 返回的 userName，想统一改成 fullName？F2 只对这部分有效，<template> 里的 {{ userName }} 不会联动更新——Vetur 不提供跨区块语义重命名。
- 光标必须落在
<script>块内变量名上，不能停在<template>的插值表达式里 - 右下角状态栏显示 “Vue (Vetur)” 是前提；若显示 “HTML” 或 “Plain Text”，说明
files.associations没配或 Vetur 被 Volar 抢占 - Vetur 对
methods和computed内部变量支持较好，但对data()返回对象的深层字段（如user.name）推导弱，建议加 JSDoc 注释辅助 - 如果 F2 按下后弹窗空白或提示 “No symbol found”，先试
Ctrl+Shift+P→Vetur: Restart VLS，再重启 VSCode 窗口
Ctrl+. 灯泡提示不出现？检查 ESLint 和 Vetur 验证开关
Vetur 的快速修复（Quick Fix）依赖两个条件同时满足：当前行有 ESLint/TS 报错，且 Vetur 的验证器已启用。否则灯泡图标根本不会亮。
vue-composition-api-best-practices
下载
Vue 3 组合式 API 与 最佳实践，涵盖代码组织、useXxx 模式、组合式函数设计、Store 集成、响应式优化及功能抽取。
- 确认
vetur.validation.template和vetur.validation.script在设置中为true（VSCode 设置搜 “vetur validation” 即可） - 确保项目根目录有
.eslintrc.js或eslintConfig字段，且规则包含vue/valid-v-for、vue/no-unused-vars等 Vue 相关规则 - 如果用了 TypeScript，
vetur.validation.script对.vue文件里的 JS 部分无效，它只校验语法，不校验类型——类型错误得靠 TS Server，此时灯泡由 TypeScript 插件提供，不是 Vetur - 禁用其他冲突插件：Prettier 的 “Format on Save” 若绑定了
.vue，可能在保存瞬间覆盖 Vetur 的修复建议，建议清空 Prettier 的vueFilesSuffixes
Extract to component 在 Vue2 里基本不可用
Vetur 提供的 “Extract to component” 功能在 Vue2 的 Options API 下几乎无法工作——它要求选中代码能独立成一个合法的组件选项对象，而实际业务逻辑往往分散在 data、methods、computed 多处，Vetur 无法自动聚合成 export default { ... } 结构。
立即学习“前端免费学习笔记（深入）”；
- 别指望右键菜单里的 Extract 功能，它大概率报错 “No valid range” 或生成空壳组件
- 真正可行的是手动拆：复制
<template>片段 → 新建Foo.vue→ 粘贴模板 → 在<script>里补props和emits声明 → 回头用 Ctrl+Shift+H 替换原文件中的引用 - 若项目已引入
@vue/composition-api，可尝试用 Volar +vueCompilerOptions.target: 2启用部分 Composition API 重构能力，但 Extract to Ref 仍只支持<script setup>，Vue2 Options API 无解 - 最省事的替代方案：用 Emmet 输入
vue快速生成新组件骨架，再把逻辑一块块搬过去，比依赖自动提取更可控
