TypeScript中如何让泛型参数无需按固定顺序传递？

云上老周

2026-9-25

实现方案

可以通过「收拢分散泛型参数为单个配置对象类型」的方式，实现类似命名传参的效果，无需按顺序传递泛型，仅指定需要自定义的字段即可，其余字段自动使用预设默认值。

第一步：定义统一的泛型配置接口

首先把所有泛型参数收拢到一个接口里，同时设置通用默认值：

interface MiddlewareOptions {
  Store: never
  Args: unknown
  Response: unknown
  // 后续新增泛型参数直接在这里加即可，不会影响原有使用逻辑
}

第二步：写泛型合并工具（简化代码）

写一个通用工具类型，自动合并用户传入的自定义配置和默认配置：

// 作用：用户传了的字段用用户的，没传的用默认值
type MergeDefault<T, Default> = T & Omit<Default, keyof T>

第三步：改造原Middleware类型

把原来的多泛型参数改为单泛型接收配置对象：

export type Middleware<T extends Partial<MiddlewareOptions> = {}> = (
  context: {
    endpoint: string
    args: MergeDefault<T, MiddlewareOptions>['Args']
    locals: {
      store?: MergeDefault<T, MiddlewareOptions>['Store']
      [key: string]: unknown
    }
  }
) => Promise<MergeDefault<T, MiddlewareOptions>['Response'] | void> | MergeDefault<T, MiddlewareOptions>['Response'] | void

使用示例

无需记忆泛型顺序，按需指定需要自定义的字段即可：

仅自定义Args类型，其余用默认值：

// 等价于原写法 Middleware<never, { id: number }, unknown>，无需手动补前置的never
type GetUserMiddleware = Middleware<{ Args: { id: number } }>

仅自定义Response和Store，跳过Args：

// 等价于原写法 Middleware<{ uid: string }, unknown, { code: number; data: any }>
type CommonMiddleware = Middleware<{ 
  Response: { code: number; data: any }, 
  Store: { uid: string } 
}>