<p>WebStorm 对 TypeScript 接口和类型别名的语义级重构依赖完整项目索引，重命名、移动、提取等操作需正确配置 tsconfig.json 和项目结构，否则易漏改 import、declare 或 export * 等场景，须配合 Find Usages、重启 TS Server 和手动验证确保一致性。</p>
Refactor 在 WebStorm 里对 TypeScript 接口（interface）和类型别名（type）做语义级重构，不是靠“查找替换”，而是依赖 IDE 对声明、导出、导入、实现、扩展关系的完整索引。前提是项目配置正确，否则它根本识别不出哪些是“同一个类型”。
重命名接口/类型时总漏改 import 或 declare 模块
WebStorm 的 Rename（Shift+F6）默认只改当前文件中该符号的**声明处 + 所有直接引用**，但以下三类不会自动同步：
-
import { MyType } from './types'中的MyType—— 如果你在types.ts里重命名了interface MyType，但其他文件的import语句没变，说明 WebStorm 没把导入语句当作“引用”来处理（常见于未启用"allowSyntheticDefaultImports": true或paths别名未被识别） -
declare module 'xxx' { export interface MyType {...} }—— 这类全局声明不会被Rename触达，必须手动同步 -
export type MyType = ...被export * from './types'导出时，重命名原文件中的MyType不会更新export *行，因为那是“重新导出”，不是“引用”
解决办法：重命名后立刻检查 Problems 工具窗口，或按 Ctrl+Shift+P → 输入 Restart TypeScript Server 强制刷新类型缓存；再用 Find Usages（Alt+F7）确认所有位置是否已覆盖。
移动 interface/type 到新文件后路径不更新
用 Refactor | Move 移动一个 interface User 到 models/user.ts，结果其他文件仍从旧路径 import { User } from './types' 导入——这通常不是操作失败，而是 WebStorm 没把项目当 TypeScript 项目解析。
检查点列表：
完整的Galileo AI平台 TypeScript/JS SDK 参考，用于评估、观察和保护 GenAI 应用。适用于构建 Node.js 或 TypeScript 项目。
- 打开
File > Project Structure > Modules，确认源码目录（如src）被标记为Sources，不是Excluded - 进
Settings > Languages & Frameworks > TypeScript > Compiler，勾选Use paths mapping from tsconfig.json（尤其当tsconfig.json里有"baseUrl"和"paths"） - 确保
tsconfig.json的"include"包含了所有用到该接口的文件，比如"include": ["src/**/*"]，不能写成"include": ["src/index.ts"] - 移动后若仍有旧路径残留，先执行
File > Synchronize，不行就File > Invalidate Caches and Restart > Just Restart
提取公共 type/interface 时无法跨文件创建
WebStorm 的 Extract Type 或 Extract Interface 功能目前**仅支持在当前文件内提取**，不支持像 Extract Method 那样弹出目标文件选择框。想把多个文件里重复的 type Status = 'idle' | 'loading' | 'error' 抽成统一定义？得手动操作：
- 先在一个文件里写好新
type Status = ...，并export - 用
Find Usages（Alt+F7）定位所有重复定义处 - 逐个删掉重复定义，改用
import { Status } from '../types/status' - 如果项目启用了 ESLint，可配
@typescript-eslint/no-redeclare规则提前拦截
注意：type 和 interface 语义不同，interface 可多次声明合并，type 不行。重构前先确认你真正需要的是哪个——别为了“抽出来”而强行把可合并的 interface 改成不可合并的 type。
上移 interface 成员到父接口时报错 “Cannot move member”
想把子接口里的字段提到父接口中，比如从 interface AdminUser extends User 里把 role: string 上移到 User，但 WebStorm 提示 Cannot move member ——这不是 bug，是限制：
- WebStorm **不支持对接口做“上移成员”重构**（
Refactor > Move Up Member只适用于 class 方法，不适用于interface或type） - 唯一可行路径是手动剪切粘贴 +
Find Usages全局更新引用，然后用Rename统一修正类型名 - 如果父接口是
declare module里的，更要小心：改完后需检查所有使用该模块的包是否兼容，否则运行时可能报Property 'role' does not exist on type 'User'
最易被忽略的一点：TypeScript 编译器本身不提供“接口字段上移”的语法糖，所以任何 IDE 的所谓“支持”都只是模拟。真正的安全重构，永远建立在 tsc --noEmit 通过 + 单元测试全绿的基础上，而不是依赖 IDE 的一键操作。
