如何在TypeScript函数签名中复用命名参数并扩展自定义参数

我正在处理两个（后续可能更多）函数，每个函数都有50多个参数，其中绝大多数参数是相同的，函数签名示例如下：

public myFunc(
    a: string,
    b: string,
    c?: number,
    .....
    cy?: boolean,
    cz?: Date,
    da?: string,
    db?: boolean,
    .....
    //And on and on into something resembling infinity
): void {}

这些函数的签名中，除了三四个参数外其余基本一致，实际参数名为username、userId、dateLastEdited这类名称。我希望单独定义通用参数（包含可选参数），并在函数签名中复用该定义，同时添加各函数独有的参数，这样既能精简代码，也便于跟踪参数差异。

我尝试过两种方案，但都存在问题：

• Rest参数方案：参数展开后丢失名称，且rest参数后无法添加可选参数，不符合需求

type baseParams = [
    a: string,
    b?: number // 需要标记该参数为可选
];

function testFunc1(requiredParam: string, ...args: baseParams, optionalParam?: string): string {
    let a = 'Oh boy it works';
    return a; // 行不通
}
let test1: string = testFunc1('Please', 'work', 0)

function testFunc2<T extends baseParams>(...args: [requiredParam: string, ...T, optionalParam?: string]): string {
    let a = 'Maybe this time?';
    return a; // 还是不行
}
let test2: string = testFunc2('No', 0, 'dice')

• 对象传参方案：代码可运行，但该函数需由自动化流程调用，无法处理对象类型参数

type baseParams = {
    a: string,
    b?: number // 需要标记该参数为可选
}

function testFunc3(requiredParam: string, args: baseParams, optionalParam?: string): string {
    args['a'] = 'Oh boy does it work?';
    return args['a'];
}
let test1: string = testFunc3('Please', {a: 'work'}, 0)

请问如何在不重复大量参数的前提下，在多个函数签名中复用带名称的类型化参数，并支持扩展自定义参数？

利用TypeScript的具名元组展开特性可以完美解决这个问题，既能复用参数定义、保留参数名称和类型提示，又完全适配 positional 参数的调用需求，符合自动化流程的要求：

1. 定义通用具名元组 #

首先把所有通用参数（包含必填和可选）定义为一个具名元组，用?标记可选参数，确保可选参数尽量放在元组末尾（符合TypeScript的参数规则）：

// 通用基础参数集合，包含具名的必填和可选参数
type BaseParams = [
  username: string,
  userId: string,
  email: string,
  // ... 其他40+必填通用参数
  dateLastEdited?: Date,
  isActive?: boolean,
  department?: string
  // ... 剩余可选通用参数
];

2. 在函数中复用并扩展参数 #

根据函数的需求，直接展开基础元组，同时添加独有的参数，分两种场景处理：

场景1：自定义参数放在通用参数之前

如果需要新增的参数是必填项，可以放在通用参数的最前面，调用时按顺序传参即可：

// 函数1：新增必填的操作类型参数，放在通用参数前
function userOperation(
  operationType: 'create' | 'update' | 'delete',
  ...baseParams: BaseParams
): void {
  // 解构通用参数，保留原始名称
  const [username, userId, email, dateLastEdited, isActive] = baseParams;
  // 业务逻辑处理
  console.log(`Performing ${operationType} for user ${username}`);
}

// 调用示例：IDE会自动提示所有参数名称和类型
userOperation('update', 'john_doe', '12345', 'john@example.com', new Date(), true);

场景2：自定义参数放在通用参数之后

如果要在通用参数后面加自定义参数，需要确保基础元组的最后一个元素是可选的，或者自定义参数也标记为可选（TypeScript要求可选参数必须在参数列表末尾）：

// 函数2：新增可选的日志ID参数，放在通用参数后
function userWithLog(
  ...[username, userId, email, dateLastEdited, isActive, logId]: [...BaseParams, logId?: string]
): void {
  console.log(`User ${username}, log ID: ${logId ?? 'N/A'}`);
}

// 调用示例：可以省略可选参数
userWithLog('jane_smith', '67890', 'jane@example.com');
userWithLog('jane_smith', '67890', 'jane@example.com', new Date(), false, 'LOG-456');

3. 多自定义参数的扩展 #

如果需要同时添加多个自定义参数，可以组合元组结构，灵活调整位置：

// 函数3：新增两个自定义参数（一个必填一个可选）
function tenantUserOperation(
  tenantId: string, // 自定义必填参数
  ...[username, userId, email, dateLastEdited, isActive, sendNotification]: [...BaseParams, sendNotification?: boolean]
): void {
  console.log(`Tenant ${tenantId}: User ${username}, send notification: ${sendNotification ?? false}`);
}

核心优势 #

• 完全保留参数名称和类型提示，IDE可自动补全，便于开发和维护
• 适配 positional 参数调用，满足自动化流程的要求
• 只需维护一份通用参数定义，避免重复代码
• 清晰区分通用参数和函数独有参数，便于跟踪参数差异

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