webstorm 安全重命名需光标定位无选中、shift+f6触发语义分析；提取方法须选完整可求值语句块；移动文件需配置tsconfig路径映射；safe delete无法识别动态导入，需手动验证。

怎么安全地重命名变量或函数

重命名是重构里最常做也最容易出错的操作，WebStorm 的 Refactor > Rename 不是简单全局替换，它会识别作用域和引用关系。但前提是光标得停在要改的名字上，且不能选中任何字符——选中了就变成文本替换，跳过语义分析。

• 右键菜单选 Rename，或按 Shift+F6（macOS 是 ⇧F6），弹出对话框后直接输新名，回车确认
• 勾选 Search in comments and strings 要谨慎：改 userId 时如果勾了，可能误改日志里的 "user ID not found"
• 如果项目用了 TypeScript，且类型声明在别处（比如 types.d.ts），重命名不会自动更新声明，得手动同步
• 遇到 Cannot refactor: reference is ambiguous 错误，大概率是同名变量在不同作用域被闭包或 import 混淆，先检查是否有多余的 import * as X from '...'

提取方法（Extract Method）总卡住或报错

想把一段逻辑抽成独立函数，但 WebStorm 提示 Cannot extract expression 或抽出来参数乱飞，根本原因是它对“可提取片段”的语法边界很敏感——必须是一段能单独求值、不依赖外部未声明变量的完整表达式或语句块。

• 确保选中的代码以完整语句开头和结尾：比如不要只选 data.map(...) 中的 ... 部分，而要选整个 data.map(x => {...})
• 避免选中含 return 的单行语句（如 return a + b;），WebStorm 会把它当返回值处理，导致新函数没返回；改成选中整个函数体内部（不含 return 关键字）更稳
• 抽出来的函数默认是 const 声明，如果原上下文在 class 里，它不会自动变成 private method，得手动改访问修饰符
• React 函数组件里提取逻辑，WebStorm 默认不加 useCallback，如果新函数要传给子组件，记得自己包一层

移动文件或类时 Import 路径没自动更新

用 Refactor > Move 移动一个 utils.ts，结果其他文件里还指着旧路径，说明 WebStorm 没触发 import 重写——这通常是因为项目没正确识别为 TypeScript 项目，或者 tsconfig.json 路径别名（paths）配置没被索引到。

• 先检查 File > Project Structure > Modules 里，对应目录是否标记为 Sources，否则 WebStorm 当普通文件夹处理，不分析 import
• 有 baseUrl 和 paths 的项目，进 Settings > Languages & Frameworks > TypeScript > Compiler，确认 Use paths mapping from tsconfig.json 已勾选
• 移动后如果某些 import 没变，别急着手动改，先点 File > Synchronize 或重启索引（File > Invalidate Caches and Restart > Just Restart）
• 移动 React 组件时，如果它被 React.lazy(() => import(...)) 动态加载，WebStorm 不会更新字符串里的路径，这部分必须手改

Safe Delete 为什么删不掉引用还在的文件

Refactor > Safe Delete 不是删除文件，而是先查引用再决定能不能删。它报 Usages found 却找不到哪儿用了，常见于 Webpack 别名、动态 require、或 Jest 的 __mocks__ 目录引用。

• 点击 Find Usages 按钮，看弹出窗口里是不是列出了 require('./xxx') 或 import(...) 这类动态导入——这些 WebStorm 默认不解析
• 如果项目用 Vite，检查 vite.config.ts 里有没有 resolve.alias，这类别名需在 WebStorm 的 Settings > Languages & Frameworks > JavaScript > Webpack 里手动指定配置路径才能被识别
• 删测试文件前留意 jest.config.js 的 setupFilesAfterEnv 或 moduleNameMapper，这些地方的字符串引用不会被检测到
• 真要硬删，可以取消勾选 Search in non-project files 和 Include tests，缩小范围，但得自己兜底验证

重构不是点几下就完事的事，WebStorm 的语义分析能力很强，但强在“已知规则”上；一旦涉及运行时拼接路径、宏定义、或自定义打包逻辑，它就只能靠你人工补全判断。别信“一键重构”，信自己多点一次 Find Usages。