TypeScript中如何为接口定义的函数参数可选属性设置默认值

首先明确两个完全独立的职责，不要混在一起：

• 你写的接口，作用是约束外部调用函数时可以传的参数结构：哪个是必传、哪个是选传，由接口的可选标记决定
• 默认值是函数内部的兜底逻辑：当外部没传对应的可选属性（值为undefined）时，给参数补一个固定值，完全不影响对外的入参约束规则

最常用的实现方式：参数解构时直接配默认值 #

你原本定义的接口完全不用改，在函数接收参数的时候通过对象解构，给每个可选属性绑上默认值就行：

// 原接口直接保留，不需要做任何修改
export interface test_interface {
  owner: string;
  length?: number;
  max_players?: number;
}

const test_function = ({
  owner,
  length = 20, // 外部没传length时，自动取默认值20
  max_players = 2 // 外部没传max_players时，自动取默认值2
}: test_interface) => {
  // 这里访问解构出来的length时，TS会自动识别为确定的number类型，不会提示可能为undefined
  const x = length;
  // 正常写业务逻辑即可
}

这种方式的好处：

• 对外的类型提示和你原本设计的完全一致，不会因为内部的默认值逻辑改变入参的约束规则
• 参数提取和默认值配置写在一起，代码紧凑可读性高，不需要写一堆if (test_props.length === undefined) ...的冗余判断

增强兜底：兼容整个入参对象缺省的场景 #

如果担心外部调用时完全不传参数对象，导致解构报错，可以给整个入参本身也加一个默认的属性兜底：

const test_function = ({
  owner = "default_owner",
  length = 20,
  max_players = 2
}: test_interface = { owner: "default_owner" }) => {
  // 就算调用时完全不传参数，函数也能靠默认值正常运行
}

要避开的常见坑 #

别为了配默认值随便改接口里的可选属性标记：很多人会图省事把接口里的length?: number改成必选的length: number，这直接就把对外的入参规则改了——相当于强制要求调用方必须传这个属性，完全失去了“可选参数+默认值”的设计意义。接口管的是「外部能传什么」，默认值管的是「内部拿到缺省值怎么处理」，两件事不冲突，没必要硬绑定。

内容的提问来源于stack exchange，提问作者Tim.Willis