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。
