WebStorm自动化重构依赖语义感知而非自动去重，需人工识别重复逻辑后通过Extract Method等操作安全收编；跨函数提取须分步执行并确保AST结构一致，否则无法复用。
WebStorm 的自动化重构不是靠“一键去重”，而是通过语义感知的提取、移动、重命名操作，把重复逻辑收拢到单一位置。它不会自动发现“看起来像”的代码块并合并——那属于静态分析工具或 AI 辅助范畴；真正可靠的做法，是人识别重复模式 + WebStorm 执行安全收编。
Extract Method 能否跨函数提取相同逻辑
不能直接跨函数提取，但可以分步完成：先在一个函数里选中重复片段，按 Ctrl+Alt+M（macOS 是 Cmd+Alt+M）提取为新函数；再在另一个函数里，手动选中结构一致的代码块，再次触发 Extract Method，WebStorm 会提示“同名函数已存在”，点击“Use existing”即可复用已有函数。
- 必须确保两处代码块语法完全等价：变量名可不同，但结构（如
if嵌套层级、map内部表达式形式）要一致 - 如果第二处提取时没弹出复用提示，说明 AST 不匹配——常见于一处用了
??，另一处用了||，或模板字符串与普通字符串混用 - 提取后检查参数：WebStorm 按“首次读取顺序”排列参数，若想统一调用签名，立刻用
Change Signature（Ctrl+F6）调整
Move Symbol 到公共文件后 import 不更新怎么办
这通常不是操作失败，而是 WebStorm 没识别到项目路径映射规则。它只在明确配置了 tsconfig.json 的 baseUrl 和 paths 时，才会重写 import 路径。
- 进
Settings > Languages & Frameworks > TypeScript > Compiler，确认勾选了Use paths mapping from tsconfig.json - 检查
File > Project Structure > Modules，目标源码目录是否标记为Sources（不是Excluded或未标记） - 移动后若仍有旧路径残留，不要手动改——先执行
File > Synchronize，再右键项目根目录 →Reload project from disk - Vue 或 React 项目中，
<script setup></script>或 JSX 里的命名导入（如import { useApi } from '@/hooks'）需确保@/别名已在Settings > Languages & Frameworks > JavaScript > Webpack中配置
Safe Delete 为什么删不掉被动态引用的函数
Safe Delete 只分析静态 import/export 关系，对 eval()、require(variable)、obj[methodName] 这类运行时行为完全不可见。它报“0 个引用”不等于函数真没被用，只是 IDE 看不见。
- 执行前务必全局搜
functionName（用Ctrl+Shift+F），重点检查字符串拼接、JSON 配置、路由定义、插件注册表等非标准调用点 - TS 项目中，如果函数被
declare module声明过，Safe Delete不会扫描类型声明文件，得手动确认 - 删完后跑一遍单元测试 + E2E，比依赖 IDE 提示更可靠
- 对高风险函数，建议先用
Rename改成old_functionName_DEPRECATED，观察几天日志和监控，再决定是否删除
最易被忽略的点：WebStorm 的重构能力严格依赖语言服务状态。如果右下角显示 Plain Text 或 JavaScript (Legacy)，所有语义操作都会退化为文本替换——此时看到的“已更新 12 处”，可能只是碰巧匹配了字符，而非真实引用。
