如何在TypeScript中简洁定义deleteCard的多状态响应接口？

针对你提到的deleteCard返回类型的定义问题，你构思的联合类型方案本身就非常适合文档化的需求，同时也能实现“继承接口并局部修改类型”的诉求，下面给出两种具体实现方式：

方案一：独立接口+联合类型（推荐，文档化最优） #

这种方式直接把两种场景的结构拆分为独立接口，联合后作为返回类型，开发者一眼就能明确不同场景的响应结构，完全符合你文档化的核心需求。

// 对应有卡片存在的场景（原AddCardResponse重命名）
interface ExistingCards {
  methods: Method[];
  default: string;
}

// 对应无卡片剩余的场景
interface NoMoreCards {
  methods: [];
  default: null;
}

// deleteCard的返回类型，明确区分两种状态
type DeleteCardResponse = ExistingCards | NoMoreCards;

这个方案的优势在于：

• 完全避免了类型定义的歧义，不会出现methods非空但default为null的无效组合
• 接口命名直观，后续开发者能快速理解不同场景的返回结构

方案二：继承+局部类型修改 #

如果你希望通过“继承已有接口，仅修改特定属性类型”的方式实现，可以借助Omit和交叉类型来减少代码重复，适合后续ExistingCards可能扩展属性的场景：

interface ExistingCards {
  methods: Method[];
  default: string;
}

// 继承ExistingCards的其他属性，仅修改methods和default的类型
type NoMoreCards = Omit<ExistingCards, 'methods' | 'default'> & {
  methods: [];
  default: null;
};

type DeleteCardResponse = ExistingCards | NoMoreCards;

这种方式的好处是，如果后续ExistingCards新增其他属性，NoMoreCards会自动继承这些属性，无需重复定义。

为什么原写法不够理想 #

你之前定义的DeleteCardResponse存在两个问题：

1. methods: Method[] | []在TypeScript中会被简化为Method[]，无法真正区分“空数组”和“非空数组”的场景
2. default: string | null允许出现属性不匹配的无效状态（比如methods有内容但default为null），而联合类型能确保两种状态的属性是严格对应的

内容的提问来源于stack exchange，提问作者gabriellend