TypeScript：传递部分可选参数，跳过其他参数

TypeScript 中缺失参数的诅咒

您是否曾经编写过一个包含十个可选参数的函数，然后试图只传递第五个和第十个参数？结果立即遇到编译错误，或者更糟的是，一个静默的逻辑错误？听起来很熟悉吧？

在 Stack Overflow 上，这个问题已经获得了数千次浏览。TypeScript 开发者们总是被同一个问题绊倒：如何传递一个可选参数，同时跳过另一个？因为标准语法不允许这样做——参数是按位置传递的，而不是按名称。

今天，我们将一劳永逸地解决这个痛点。我将向您展示4 种有效的方法来解决这个问题：从简单的重构到使用 partial 对象的高级技术。我们开始吧！

为什么这会是问题？位置诅咒

在 TypeScript（以及 JavaScript）中，函数参数是按顺序传递的。如果您有一个函数：

function createUser(\n  name: string,\n  age?: number,\n  email?: string,\n  isAdmin?: boolean\n) { /* ... */ }

您不能这样调用它：createUser('John', , 'john@mail.com')。跳过参数会留下一个空洞，TypeScript 无法处理。您必须传递 undefined 或 null，这会使代码和逻辑变得混乱。

但好消息是：我们可以通过几种优雅的方式绕过这个限制。让我们逐一分析。

方法 1：参数对象（最正确的方法）

这是严肃项目中推荐的模式。与其使用一堆位置参数，不如使用一个包含可选字段的对象：

interface UserOptions {\n  name: string;\n  age?: number;\n  email?: string;\n  isAdmin?: boolean;\n}\n\nfunction createUser(options: UserOptions): void {\n  const { name, age, email, isAdmin } = options;\n  console.log(`用户 ${name} 已创建，年龄：${age ?? '未指定'}`);\n}\n\n// 现在可以只传递需要的参数！\ncreateUser({ name: '安娜', email: 'anna@mail.com' });\ncreateUser({ name: '彼得', isAdmin: true });\n

优点显而易见：

\n
• 无论有多少参数，只传递需要的部分
\n
• 代码自文档化：一眼就能看出每个参数的作用
\n
• 无需更改函数签名即可轻松添加新字段
\n

这种方法解决了 90% 的可选参数问题。但如果您在处理遗留代码或无法更改 API，请继续阅读。

方法 2：函数重载

TypeScript 允许为一个函数声明多个签名。当您有特定的参数组合时，这很方便：

// 声明重载\nfunction getData(url: string): Promise<any>;\nfunction getData(url: string, timeout: number): Promise<any>;\nfunction getData(url: string, timeout: number, retries: number): Promise<any>;\n\n// 实现（必须是最通用的）\nfunction getData(\n  url: string,\n  timeout?: number,\n  retries?: number\n): Promise<any> {\n  // 逻辑\n  return fetch(url, { signal: AbortSignal.timeout(timeout ?? 5000) });\n}\n\n// 现在可以这样调用：\ngetData('/api/users');               // timeout = 5000（默认值）\ngetData('/api/users', 3000);         // timeout = 3000\n// 但这样不行（没有重载时不允许跳过 timeout）：\n// getData('/api/users', undefined, 2); // 不好\n

缺点：重载不能解决跳过中间参数的问题。它们只提供严格的组合。对于灵活的参数传递，最好使用方法一。

方法 3：Rest 参数 + 解构（特殊方法）

如果您想保留位置参数但增加灵活性，可以使用带有 rest 的元组：

type OptionalParams = [number, string?, boolean?];\n\nfunction processData(\n  required: string,\n  ...opt