如何设计函数参数，让用户直观区分互斥与兼容选项？

针对你这个A、B互斥但C可与任意选项共存的场景，完全可以通过优化参数设计让用户直观感知规则，甚至在编译期就避免错误。以下是几个实用方案：

方案1：用TypeScript联合类型强制互斥（编译期校验） #

直接在类型定义层面限制A和B不能同时为true，让TS用户写代码时就收到报错提示，不需要等到运行时抛错。类型定义可以这么写：

type PrintLibOptions = 
  | { A: true; B?: never; C?: boolean }
  | { B: true; A?: never; C?: boolean }
  | { A?: false; B?: false; C?: boolean };

async function printLib(options: PrintLibOptions) {
  // 实现逻辑，此时不需要再判断A和B同时为true的情况
}

这个方案的优势是强制校验，用户如果尝试同时传{A: true, B: true}，TS会直接报错，从根源避免错误，而且类型定义本身就是最好的文档。

方案2：拆分参数结构，明确互斥组 #

把互斥的A、B拆成独立的枚举参数，C作为单独的可选布尔项，API设计更直观，用户一眼就能看懂规则：

type PrintLibMode = 'A' | 'B';

async function printLib(options: { mode?: PrintLibMode; C?: boolean }) {
  const isA = options.mode === 'A';
  const isB = options.mode === 'B';
  // 实现逻辑
}

调用的时候用户只能选{mode: 'A', C: true}或者{mode: 'B'}，不会出现同时选A和B的情况，完全符合你的需求。这个方案对非TS用户也友好，看参数名就知道怎么用。

方案3：保留原结构，增强文档提示（兼容现有用户） #

如果不想大改现有API，可以通过注释和运行时校验结合，让用户明确规则：

/**
 * 打印库核心函数
 * @param options 配置选项
 * @param options.A 启用A功能（不能与B同时设为true）
 * @param options.B 启用B功能（不能与A同时设为true）
 * @param options.C 启用C功能（可与A/B任意搭配）
 */
async function printLib(options: { A?: boolean; B?: boolean; C?: boolean }) {
  if (options.A && options.B) {
    throw new Error('A和B不能同时启用');
  }
  // 实现逻辑
}

这个方案的好处是兼容现有用户，但依赖用户阅读文档，不如前两个方案主动避免错误。

是否需要重构？ #

如果你的库还在初期、用户量少，优先选方案2，API更简洁直观；如果已经有不少用户在使用原API，可以先做方案3的文档增强，再逐步引导用户迁移到方案1或2。

至于你提到的"A" | "B" | "C"字符串参数方案，确实只适用于所有选项完全互斥的场景，不符合你这里C可与A/B共存的需求，所以不建议用。

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