文件重命名必须用 refactor → rename（f6），不可用 shift+f6 或 f2；勾选“search for text occurrences”才能更新 import 路径，否则引用不生效。
文件重命名必须用 Refactor → Rename，不是 Shift+F6
Shift+F6 是语义级符号重构（变量、函数、类），它不处理文件名。想改 index.html 为 home.html，必须走文件层级的重命名流程，否则 import 路径、路由配置、引用链接全都不会更新。
正确做法是：在项目视图中**右键点击目标文件** → 选择 Refactor → Rename；或选中文件后按 F6（注意：不是 Shift+F6）——WebStorm 会把 F6 绑定到文件/目录重命名操作上，而 Shift+F6 始终留给 AST 级符号重构。
常见错误包括：
- 对文件按
Shift+F6，弹窗里只显示 “In File”，且无法修改路径 —— 这是 IDE 明确拒绝你用符号重构方式改文件名 - 直接 F2 改名，结果只是编辑器标签变名，磁盘文件和引用完全没动
- 在编辑区打开文件后按
F6，但光标不在文件名上（比如停在 HTML 标签里），此时F6会失效或触发其他行为
Refactor → Rename 对话框里两个复选框怎么选
执行重命名后弹出的对话框底部通常有两项勾选项：
-
Search in comments and strings：默认不勾。除非你真希望把"./index.html"这样的字符串也替换成"./home.html"，否则别开——它会误改 JSON 配置、正则字面量、Vue 模板里的动态路径等 -
Search for text occurrences：这个才是关键。勾上它，WebStorm 才会扫描整个项目，找出所有硬编码的该文件路径（如import、require、fetch('./index.html')、Webpack alias 引用等），并批量更新
如果项目用了 tsconfig.json 的 paths 别名（比如 @/pages/index），这项必须勾，否则别名引用不会同步更新。
重命名后 import 路径没变？检查是否漏了这三步
即使勾了 Search for text occurrences，仍可能出现 import 不更新的情况，常见原因如下：
- 文件未被 WebStorm 索引：右下角状态栏显示
Plain Text或项目未正确加载 TypeScript 支持，导致路径解析失败 - 路径写法绕过了静态分析：比如
import(`./${page}.js`)动态导入、require('./' + name)字符串拼接，这些 WebStorm 无法识别，必须人工 grep - 引用来自非标准位置：如
node_modules中的包、未被tsconfig.json.include覆盖的类型声明文件（types.d.ts）、或 Babel 插件生成的代码，重构不会触达
验证是否生效最直接的方式：改完后在任意 import 行按 Ctrl+B，看能否跳转到新文件；跳不到，说明路径没更新成功。
为什么不能用 Ctrl+R 或 Find & Replace 改文件名
Ctrl+R 是纯文本替换，风险极高：
- 把
index.js改成home.js，连indexId、indexOf、"index"字符串、/index\/\d+/正则都一起改了 - 路径分隔符差异导致漏改：Windows 用
\，Linux/macOS 用/，Ctrl+R不懂上下文，可能只改一半 - 无法区分相对路径与绝对路径：
./index.js和/src/index.js可能都被命中，但后者不该动
真正的文件重命名是元数据操作：改磁盘文件名 + 更新所有静态可识别的引用路径 + 保持 Git 历史连续性。Refactor → Rename 是唯一能兼顾这三点的方式。
最易被忽略的一点：重命名文件后，如果原文件被其他模块通过 export * from './index' 导出，那些星号导出语句里的路径不会自动更新——WebStorm 目前不解析这种间接引用，得手动修。
