WebStorm不自动生成解耦重构辅助代码，所有解耦操作必须基于已有结构手动触发，否则退化为文本替换或报错；Extract Method仅语法切割、不处理依赖，Move文件需满足TypeScript识别、tsconfig路径映射启用及目录标记为Sources等前提。
WebStorm 不能“自动生成解耦重构辅助代码”——它不提供抽象层、适配器或依赖注入容器的模板，所有所谓“解耦”操作都必须基于你已有的具体结构手动触发，否则就是文本替换或报错。
Refactor > Extract Method 不等于解耦，只是拆函数
很多人以为 Extract Method（Ctrl+Alt+M）能自动帮你把紧耦合逻辑抽成可测试单元，其实它只做语法合法的切割，不管职责或依赖：
- 选中代码里含
this、arguments或闭包变量（如 React 组件里的id），提取后上下文会丢失，WebStorm 只警告不阻止 - 若原逻辑调用
fetch、localStorage或第三方 SDK，提取出的函数仍硬编码这些依赖，没做参数化或接口抽象 - 参数顺序按“首次读取”排列，不是按语义分组；想把
userId和apiUrl归为“请求配置”，得先手动调整原代码中它们的使用顺序 - React 函数组件内提取 JSX 片段时，不会自动加
useCallback，也不会检查是否该提升到父组件作用域
Move 类/文件 ≠ 解耦，路径更新失败很常见
移动一个 utils.ts 到 src/lib/ 目录，不代表它就和业务逻辑解耦了。WebStorm 的 Refactor > Move 是否生效，取决于三件事：
- 项目是否被识别为 TypeScript：右下角状态栏必须显示
TypeScript，不是Plain Text或JavaScript -
tsconfig.json是否被正确索引：进Settings > Languages & Frameworks > TypeScript > Compiler，确认勾选了Use paths mapping from tsconfig.json - 目标目录是否标记为 Sources：在
File > Project Structure > Modules中，src/lib/必须是蓝色 Sources 文件夹，否则 import 路径不会重写 - 移动后部分 import 没变？别急着手改，先
File > Synchronize或Invalidate Caches and Restart > Just Restart
Change Signature 改参数，但不帮你设计契约
给函数加一个 httpClient: AxiosInstance 参数看似是解耦，但 WebStorm 的 Change Signature（Ctrl+F6）只负责补调用处、改声明，不判断这个参数是否合理：
- 添加必填参数后，所有调用处自动填
undefined或空字符串——这大概率导致运行时报错，得立刻grep -r "myFunction("全局检查并补真实实例 - 如果原函数用
fetch，你改成接收httpClient，WebStorm 不会帮你删掉旧的fetch调用，也不会校验传入的 client 是否有.get()方法 - TS 类型变化不会自动同步到 JSDoc 或测试文件；
describe('myFunction', () => { ... })里的 mock 也得你手动更新 - 参数名改了但类型没改（比如从
data: any到data: User），TypeScript 编译器才真正开始报错，IDE 不会提前预警
AI Assistant 不理解“解耦”，只响应具体指令
WebStorm 的 AI Assistant 默认不启用，且对“解耦”这种抽象概念无感知。它只能执行你明确说出来的动作：
- 启用前提：必须登录 JetBrains 账户，并在
Settings > Advanced Settings > AI Assistant中勾选Enable AI Assistant - 无效提示词：
“make this function more decoupled”→ AI 会返回格式优化或加注释 - 有效提示词：
“Extract the API call into a separate function that accepts baseUrl and token as parameters, and rename internal variables to match the new scope” - 生成结果默认不应用，必须人工核对：是否误删了
try/catch、this绑定是否还在、泛型参数是否丢失 - JS 文件识别率比 TS 低约 40%；若用了
// @ts-ignore或any，AI 会跳过相关分支，直接忽略那部分逻辑
真正的解耦不在工具里，在你决定把哪块逻辑划归哪个模块、谁负责创建依赖、谁负责消费接口的那一刻。WebStorm 只负责把你的决定安全落地——前提是光标位置对、语言识别准、项目配置齐。漏掉任何一环，它就退化成高级查找替换。
