如何使用TypeScript类型参数为类动态添加属性？

你当前的核心问题是：泛型Extra只约束了构造函数的参数类型，但Base类本身的类型定义并未包含Extra的属性，导致访问动态添加的属性时TypeScript无法识别。下面提供两种可行的解决方案：

方案一：接口合并（兼容性好） #

通过定义同名接口并继承Extra，让类的实例类型自动合并基础属性与额外属性：

type BaseOptions<Extra extends object = {}> = {
    price: number
    image: string
} & Extra

// 让Base接口继承Extra，实现实例类型的自动合并
interface Base<Extra extends object = {}> extends Extra {}

class Base<Extra extends object = {}> {
    price: number
    image: string

    constructor(options: BaseOptions<Extra>) {
        // 用Object.assign替代循环，简洁完成所有属性赋值
        Object.assign(this, options)
    }
}

方案二：类内映射类型声明（TS 4.4+） #

直接在类内部用映射类型声明Extra的所有属性，让TypeScript明确知晓这些属性的存在：

type BaseOptions<Extra extends object = {}> = {
    price: number
    image: string
} & Extra

class Base<Extra extends object = {}> {
    price: number
    image: string
    // 用映射类型声明Extra中的所有属性
    declare [K in keyof Extra]: Extra[K]

    constructor(options: BaseOptions<Extra>) {
        Object.assign(this, options)
    }
}

效果验证 #

两种方案都能保留构造参数的类型校验，同时让动态添加的属性被TypeScript正确识别：

// 构造参数缺失Extra属性时，仍会触发类型错误提示
new Base<{ hello: string }>({
    image: "",
    price: 2
})

// 访问额外属性时，TypeScript能正确识别其类型
const instance = new Base<{ hello: string }>({
    image: "",
    price: 2,
    hello: "test"
})
instance.hello // 类型为string，无报错

内容的提问来源于stack exchange，提问作者Space.yg