如何用TypeScript定义含1个必填3个可选、可任意组合参数且带类型提示的函数

不用写一堆函数重载，直接把三个可选参数合并成一个可选的配置对象，既能支持任意组合传参，又能保留完整的类型提示，代码还更简洁。

步骤1：定义基础类型 #

先明确三个可选参数的类型（根据实际业务替换即可）：

type ParamsType = { id: number; keyword?: string };
type ConfigType = { timeout: number; headers?: Record<string, string> };
type OptionType = { retry: boolean; retryCount?: number };

步骤2：定义函数 #

将三个可选参数打包成一个可选的对象参数，用TS可选属性语法约束：

function request(url: string, options?: {
  params?: ParamsType;
  config?: ConfigType;
  option?: OptionType;
}) {
  // 解构参数，默认空对象避免报错
  const { params, config, option } = options || {};
  
  // 业务逻辑示例
  if (params) console.log('请求参数:', params);
  if (config) console.log('请求配置:', config);
  if (option) console.log('请求选项:', option);
}

步骤3：任意组合调用 #

调用时可自由组合需要的参数，IDE会自动给出完整类型提示：

// 仅传params
request('https://example.com', { params: { id: 1 } });

// 仅传config
request('https://example.com', { config: { timeout: 5000 } });

// 仅传option
request('https://example.com', { option: { retry: true } });

// params + option
request('https://example.com', { params: { id: 2 }, option: { retry: true, retryCount: 3 } });

// config + option
request('https://example.com', { config: { timeout: 10000 }, option: { retry: false } });

// params + config
request('https://example.com', { params: { id: 3, keyword: 'test' }, config: { timeout: 3000 } });

// 三个参数都传
request('https://example.com', {
  params: { id: 4 },
  config: { timeout: 8000 },
  option: { retry: true }
});

// 不传可选参数
request('https://example.com');

为什么这比函数重载好？ #

• 无需手动维护所有参数组合的重载签名，避免代码冗余
• 调用方式更直观，所有可选参数集中在一个对象里，语义清晰
• 类型提示完整，IDE自动补全可选属性和对应类型
• 后续新增/修改可选参数时，仅需调整配置对象的类型定义，无需修改函数签名

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