TypeScript接口条件可选参数：二选一必填/可选实现方案问询

首先明确：TypeScript的原生接口语法没法直接声明「两个属性二选一必填」，但我们可以通过联合类型或自定义工具类型来实现需求，而且不用单独创建多个冗余的独立接口。

方案1：严格二选一（禁止同时提供两个属性） #

如果你需要严格限制只能传firstname或者name中的一个，不能同时提交两个属性，那可以用联合类型结合never类型来实现：

type IMyInterface = 
  // 仅传入firstname，name不允许存在
  { firstname: string; name?: never } 
  // 仅传入name，firstname不允许存在
  | { name: string; firstname?: never };

这种写法下，TypeScript会在你同时传入两个属性时直接报错，完美贴合「二者只能选其一」的严格要求，全程只用了类型字面量的联合，没有额外创建独立接口。

方案2：至少二选一（允许同时提供两个属性） #

如果你的需求是只要有其中一个属性即可，另一个可填可不填（甚至允许同时提交两个），那可以用交叉类型组合「可选属性」和「至少一个必填」的约束：

type IMyInterface = 
  // 先把两个属性都设为可选
  { firstname?: string; name?: string } 
  // 再通过交叉强制要求至少有一个是必填的
  & ({ firstname: string } | { name: string });

这种写法下，你可以只传firstname、只传name，或者两个都传，唯独不能两个都不传，完全满足「提供其中一个时另一个可省略」的核心需求。

方案3：封装通用工具类型（优雅复用） #

如果以后还有类似的二选一需求，我们可以封装一个通用的XOR（异或）工具类型，既简洁又符合「不重复造轮子」的要求：

先定义通用工具类型：

// 移除两个类型的交集属性，确保二选一的排他性
type Without<T, U> = { [P in Exclude<keyof T, keyof U>]?: never };
// 实现异或逻辑：只能选择T或U中的一个类型
type XOR<T, U> = (T | U) extends object ? (Without<T, U> & U) | (Without<U, T> & T) : T | U;

然后用这个工具类型定义你的目标类型：

// 如果有公共属性，可以先定义基础接口（可选）
interface IBaseInterface {
  // 例如 age?: number; 这类公共字段
}

// 组合基础接口和二选一约束
type IMyInterface = IBaseInterface & XOR<{ firstname: string }, { name: string }>;

这个方案的优势在于复用性极强，以后任何需要二选一的场景都可以直接调用XOR类型，不用重复编写联合逻辑。

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