如何定义含任意属性且option必须为number的TypeScript交叉类型？

问题原因 #

你之前用type PropsWithOption = object & {option?:number}的写法失效，是因为object类型本身不包含索引签名，TypeScript会对这类交叉类型进行严格的额外属性检查——它认为该类型只能包含option属性（或空对象），任何额外属性都会被判定为不匹配。

解决方案 #

有两种简洁的方式实现需求：

方式1：直接使用索引签名 #

定义一个带有字符串索引签名的类型，同时显式指定option的类型：

type PropsWithOption = {
  [key: string]: unknown; // 允许任意字符串键的属性，值类型可根据需求换成any/unknown等
  option?: number; // 强制option为可选的number类型
};

方式2：结合Record工具类型与交叉类型 #

用Record<string, unknown>生成允许任意属性的基础类型，再与指定option类型的对象交叉：

type PropsWithOption = Record<string, unknown> & { option?: number };

验证示例 #

// 合法用法（无报错）
const emptyObj: PropsWithOption = {};
const onlyOption: PropsWithOption = { option: 100 };
const withExtraProps: PropsWithOption = {
  username: "zhangsan",
  isActive: true,
  option: 200
};

// 非法用法（触发报错，符合预期）
const invalidOption: PropsWithOption = { option: "abc" }; // 类型不匹配

补充说明 #

• 索引签名里的unknown可以换成any，但推荐用unknown保持类型安全，后续使用额外属性时需要做类型窄化。
• 如果你需要允许任意类型的键（比如数字键），可以把索引签名改成[key: string | number]: unknown，不过JavaScript对象的数字键最终会被转为字符串，所以通常字符串索引足够覆盖需求。

内容的提问来源于stack exchange，提问作者최충우