能否根据参数动态切换TypeScript属性的必填/可选状态？

要实现你说的「传query就必须传column和row，不传query则无需这两个参数」的约束，不能用单一接口，得用联合类型来区分两种互斥的参数场景。

具体实现步骤： #

1. 定义两种参数类型：
   • 带查询条件的类型：query、column、row全必填
   • 不带查询条件的类型：明确禁止传入query，column和row可选
2. 把这两种类型合并成联合类型，作为函数的参数约束。

完整代码示例： #

// 带查询条件的参数类型：query/column/row 必填
interface GoogleSheetsWithQuery {
  sheetId: string;
  query: string;
  column: string;
  row: string;
}

// 不带查询条件的参数类型：禁止传入query，column/row 可选
interface GoogleSheetsWithoutQuery {
  sheetId: string;
  query?: never;
  column?: string;
  row?: string;
}

// 联合两种类型，作为函数的参数约束
type GoogleSheetsConfig = GoogleSheetsWithQuery | GoogleSheetsWithoutQuery;

export const fetchGoogleSheet = async ({
  sheetId,
  query,
  column,
  row,
}: GoogleSheetsConfig) => {
  if (query) {
    // 此处TypeScript会自动推断：column和row一定存在，无需额外运行时判断
    console.log('执行查询:', query, '列:', column, '行:', row);
  } else {
    console.log('直接操作表格，无需查询');
  }
};

类型检查效果： #

• ✅ 合法调用：传query时必须带column和row

  fetchGoogleSheet({ sheetId: '123', query: 'select *', column: 'A', row: '1' });
  

• ✅ 合法调用：不传query时，column和row可传可不传

  fetchGoogleSheet({ sheetId: '123' });
  fetchGoogleSheet({ sheetId: '123', column: 'B' });
  

• ❌ 错误调用：传了query但缺column或row，TypeScript编译阶段直接报错

  fetchGoogleSheet({ sheetId: '123', query: 'select *' }); // 报错：缺少column和row
  

关键细节： #

• 用query?: never是为了确保两种场景完全互斥：不带查询的参数里，query要么不传，要么传undefined，绝对不能传字符串值。
• 联合类型让TypeScript能自动做分支推断：在if (query)的分支里，类型系统会自动确认column和row是必填存在的，省去冗余的运行时检查（如果要兼容纯JS调用，仍可保留检查，但编译阶段已经拦截了大部分错误）。

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