shift+f6重命名失效因文件未被识别为vue+typescript，需确保扩展名为.vue、启用volar、关闭vetur；ctrl+alt+m提取失败因选区不满足语法闭合、跨作用域或含模板语法；路径未更新需检查tsconfig路径映射、src标记为sources并清理缓存；extract variable不支持ref()需改用reactive。
Shift+F6重命名在Vue组件里为什么失效
光标停在defineProps参数名或ref变量上却没反应，大概率是语言识别错了。WebStorm必须把当前文件识别为Vue + TypeScript才能走语义重命名——右下角状态栏显示Vue或TypeScript才算数，显示Plain Text或HTML就直接退化成文本替换。
常见卡点：
- 文件扩展名不是
.vue，而是.html或.ts；Vue单文件组件必须用.vue -
<script setup lang="ts"></script>里用了未声明的类型（比如interface User没定义），TS Server报错会导致语义分析中断 - 没启用Volar插件，或者同时开着Vetur——二者冲突会让WebStorm丢掉Composition API上下文
- 光标选中了文字，哪怕只多按了一个
Shift，Shift+F6就变成查找替换
Ctrl+Alt+M提取逻辑块到组合式函数时总失败
想把onMounted里的一段API调用抽成useUserProfile，但按下Ctrl+Alt+M后提示“Cannot extract fragment”，说明你选的代码不满足语法闭合要求。
必须满足三个硬条件：
- 光标起始位置得在完整语句开头，比如
const data = await fetchUser();这行最前面，不能在中间或末尾 - 不能跨
setup()作用域——比如从<script setup></script>里选中onMounted(() => { ... })内部某几行，必须包含整个onMounted调用表达式 - 不能含模板语法干扰，比如
{{ user.name }}或v-if="loading"出现在选区里，AST解析会直接放弃
成功提取后，参数顺序按首次读取变量决定：如果原代码里先用了userId再用token，生成的函数签名就是(userId, token)，改顺序得先调换原代码里的使用顺序。
移动组件文件后import路径没自动更新
把src/components/UserCard.vue拖进src/modules/profile/，结果所有引用它的文件还连着旧路径，不是WebStorm偷懒，是它根本没读到你的路径映射配置。
检查这三处：
- Settings → Languages & Frameworks → TypeScript → Compiler → 勾选
Use paths mapping from tsconfig.json - File → Project Structure → Modules → 确认
src目录被标记为Sources（蓝色图标），否则不参与路径索引 - 刚改过
tsconfig.json里的baseUrl或paths？立刻执行File → Invalidate Caches and Restart，缓存不清理，新配置等于没写
Extract Variable对响应式变量不起作用
想把const name = ref('')和const avatar = ref('')一起抽成对象解构，但Ctrl+Alt+V只对普通变量生效，对ref()返回值默认忽略——因为WebStorm认为ref本身是函数调用，不是纯值表达式。
workaround很直接：
- 先手动写
const { name, avatar } = reactive({ name: '', avatar: '' }) - 再用Ctrl+Alt+V把
{ name: '', avatar: '' }这部分抽成常量INITIAL_STATE - 最后把
reactive替换成ref并调整结构——WebStorm不会帮你做这个转换，得自己补
真正省事的做法是别抽，直接用const state = reactive({ ... })，既符合Composition API习惯，又让重构功能能识别整块数据结构。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
