TypeScript如何定义仅允许二选一必填参数的接口？

这问题我太熟悉了！要实现「必须且只能传入content或content_object其中一个」的约束，最简洁也最贴合你需求的方式是用联合类型拆分接口，而不是把两个可选属性塞在同一个接口里。

具体实现步骤 #

首先，我们把两种情况拆成两个独立的接口，分别对应字符串内容和对象内容的场景：

// 仅包含字符串content的接口
interface StringContentModal {
  content: string;
}

// 仅包含对象content_object的接口
interface ObjectContentModal {
  content_object: object;
}

然后用联合类型把它们合并成最终的IModal类型：

type IModal = StringContentModal | ObjectContentModal;

为什么这比string | object更好？ #

• 强制二选一：TypeScript会严格校验——你必须传其中一个属性，不能同时传两个，也不能都不传，完美满足你的需求。
• 更精准的类型提示：后续代码里做类型窄化时（比如用'content' in modal判断），TypeScript能准确识别当前是哪种类型，自动补对应属性的提示，比把两种类型混在一个属性里的写法友好太多，完全符合你说的「对后续代码更有利」的要求。

举几个例子验证 #

// ✅ 合法：只传content
const validTextModal: IModal = { content: "这是一段文本内容" };

// ✅ 合法：只传content_object
const validObjectModal: IModal = { content_object: { title: "模态框", body: "详细内容" } };

// ❌ 非法：同时传两个属性
const invalidBothModal: IModal = { content: "文本", content_object: {} }; // TypeScript会直接报错

// ❌ 非法：两个属性都不传
const invalidNoneModal: IModal = {}; // 同样会报错

如果有公共属性怎么办？ #

如果你的模态框还有其他公共配置（比如标题、是否可见等），可以先抽一个基础接口，再让两个内容接口继承它：

// 公共属性抽离
interface BaseModalConfig {
  title: string;
  visible: boolean;
  onClose?: () => void;
}

interface StringContentModal extends BaseModalConfig {
  content: string;
}

interface ObjectContentModal extends BaseModalConfig {
  content_object: object;
}

type IModal = StringContentModal | ObjectContentModal;

这样既保留了公共配置，又维持了二选一的约束，扩展性拉满～

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