文件重命名必须用refactor→rename并按f6，因shift+f6仅处理ast节点不识别文件名；正确操作需在项目视图右键或选中文件后按f6、确保文件被索引、勾选search for text occurrences。
文件重命名必须走 Refactor → Rename，按 F6（不是 Shift+F6），否则 import 路径、路由配置、动态引用全都不会更新。
为什么不能用 Shift+F6 改文件名
Shift+F6 是语义级符号重构，只处理变量、函数、类等 AST 节点；它根本不识别文件名——光标停在 index.html 上按 Shift+F6，弹窗只会显示 “In File”，且路径栏灰掉不可编辑。WebStorm 明确拒绝把文件名当符号处理。误用后你会看到：文件磁盘名没变、标签页还叫 index.html、所有 import 仍指向旧路径。
正确触发文件重命名的三个条件
必须同时满足以下三点，Refactor → Rename 才能扫描并更新引用：
- 在项目视图（Project tool window）中右键点击目标文件，或选中文件后按
F6—— 不是在编辑区打开文件后按F6（此时光标在 HTML 内容里，IDE 默认触发元素重命名） - 确保该文件已被 WebStorm 索引：右下角状态栏显示语言标识（如
JavaScript、TypeScript或HTML），而不是Plain Text - 重命名对话框中必须勾选
Search for text occurrences—— 这是唯一控制 import、require、fetch 路径是否更新的开关；Search in comments and strings建议不勾，否则会误改 JSON 字段、正则字面量、Vue 模板里的字符串路径
import 路径没更新？先查这三处
即使勾了 Search for text occurrences，仍可能漏更新，常见原因：
- 路径是动态拼接的，比如
import(`./${page}.ts`)或require('./' + name)—— WebStorm 静态分析无法识别，必须人工grep或全局搜索./oldname - 引用来自未被索引的位置：如
node_modules中的包、types.d.ts、或 Babel 插件生成的代码，重构不会触达 - 项目用了
tsconfig.json的paths别名（如@/pages/index），但没勾Search for text occurrences，别名引用就不会同步
验证是否生效最直接的方式：改完后在任意 import 行按 Ctrl+B，看能否跳转到新文件；跳不到，说明路径没更新成功。
别用 Ctrl+R / Find & Replace 改文件名
Ctrl+R 是纯文本替换，它不管作用域、不校验语法、不识别模块系统。用它把 index.js 替成 home.js，结果连注释里的 // index.js is legacy 和 JSON 配置中的 "entry": "index.js" 全都改了，甚至可能破坏正则字面量 /index\.js$/。这不是重构，是风险操作。
