TypeScript 接口设计

接口描述数据契约，先确定输入输出形状，再决定实现细节，能降低模块耦合。

核心说明

接口描述对象的公共形状，适合表达组件 props、接口响应和领域数据。好的接口只暴露真正稳定的字段，避免把临时实现细节扩散到整个项目。

关键点

• 可选字段要说明缺失时的行为，而不是让每个调用者自行猜测。
• 输入类型和输出类型分开定义，避免一个类型同时承担两个方向。
• 接口改变时优先搜索所有使用处，再决定兼容还是迁移。