如何将数组强制转换为指定的TypeScript interface自定义类型？

能否直接强制转换？ #

不能。TypeScript的类型断言仅作用于编译阶段，不会修改运行时的实际数据结构。如果直接使用[1,2,3,4,5] as unknown as player_info，编译时不会报错，但运行时访问对象属性会得到undefined，完全不符合预期。

实现方案 #

方案1：手动按索引映射（最稳妥，可读性最高） #

interface player_info {
    local: number,
    client_id: number,
    team: number,
    score: number,
    latency: number
}

function convertArrayToPlayer(arr: number[]): player_info {
    // 前置校验数组长度，避免异常
    if (arr.length < 5) {
        throw new Error('数组长度不符合转换要求，至少需要5个元素')
    }
    return {
        local: arr[0],
        client_id: arr[1],
        team: arr[2],
        score: arr[3],
        latency: arr[4]
    }
}

// 调用示例
const sourceArr = [1, 2, 3, 4, 5]
const playerInfo: player_info = convertArrayToPlayer(sourceArr)

方案2：通用映射写法（适合属性较多的场景） #

如果后续interface属性有调整，可以只修改属性名列表，不用逐个修改索引映射：

const PLAYER_PROPS = ['local', 'client_id', 'team', 'score', 'latency'] as const

function convertArrayToPlayer(arr: number[]): player_info {
    if (arr.length < PLAYER_PROPS.length) {
        throw new Error('数组长度与player_info属性数量不匹配')
    }
    return Object.fromEntries(
        PLAYER_PROPS.map((prop, idx) => [prop, arr[idx]])
    ) as player_info
}

注意事项 #

• 必须添加运行时的数组长度校验，避免传入长度不足的数组导致属性值为undefined，和interface定义的number类型冲突
• 禁止直接使用类型断言跳过结构转换，否则会带来线上运行时隐患

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