vue组件名重命名不能仅改name字段字符串，因模板、路由、动态组件及全局注册等处的字符串引用需手动同步更新，webstorm的shift+f6仅重构标识符而非字符串字面量。
Vue组件名重命名不能只改 export default defineComponent({ name: 'OldName' }) 里的字符串，否则模板、路由、<component :is></component> 和全局注册都会失效。
为什么 Shift+F6 改不了组件名
WebStorm 的 Shift+F6 是语义级重命名，只处理 AST 中的变量、函数、类等声明，不解析字符串字面量。组件名在 name 字段里是字符串，不是标识符，所以按 Shift+F6 停在 'OldName' 上毫无反应——IDE 根本不把它当可重构目标。
- 常见错误现象：
Unknown custom element: <old-name></old-name>报错，但你确信已“重命名”了组件 - 根本原因：光标停在字符串内，状态栏显示 Plain Text 或 HTML，或文件未被识别为 Vue + TypeScript
- Vue SFC 必须满足三个条件才能触发语义分析：扩展名是
.vue、<script setup lang="ts"></script>正确标注、Volar 插件启用且 Vetur 已禁用
哪些地方必须手动同步更新
组件名作为弱引用，散落在多个非 AST 可达位置，Shift+F6 不会触达，必须人工检查：
- 所有
<old-name></old-name>、<oldname></oldname>、<old-name></old-name>（大小写和连字符敏感）形式的模板标签 - 路由配置中
component: OldName或component: () => import('./OldName.vue') - 动态组件：
<component :is="currentComponent"></component>对应的字符串值（如currentComponent = 'old-name'） - 全局注册：
app.component('old-name', OldName)中第一个参数是字符串，必须手改 - 第三方库调用：
<el-button type="primary"></el-button>这类不会动；但像<el-table-column prop="oldName"></el-table-column>中的prop值若与组件名同名，也得人工判断
如何安全地批量替换字符串引用
既然语义重命名走不通，就得用精准的文本替换，但必须避开误伤区：
- 用
Find → Replace in Path（Ctrl+Shift+R），范围选Directory，勾选Match case和Words only，避免把oldNameSuffix也替掉 - 正则模式下慎用
.*，优先用字面量匹配：<old-name></old-name>、name: 'old-name'、component: oldName - 对
import路径，先确认 tsconfig.json 的paths已启用（Settings > Languages & Frameworks > TypeScript > Compiler > Use paths mapping from tsconfig.json），再执行文件重命名（右键文件 →Refactor → Rename，勾选Search for text occurrences） - 替换后立刻验证：
Ctrl+B点击任意import语句，看是否跳转到新文件；在模板里Ctrl+Click组件标签，确认能定位到定义
最易被忽略的是 defineAsyncComponent 和 router.addRoute 这类运行时注册逻辑——它们不依赖静态 import，也不出现在 AST 引用链里，必须靠 grep 或全局搜索 old-name 字符串来兜底。
