实现对象映射辅助工具时遭遇Type Error问题求助

问题根源 #

你遇到的类型错误，本质是ts-extras库的objectEntries函数返回的key类型和你定义的泛型K不匹配。objectEntries会将非symbol类型的key转换为模板字符串类型${Exclude<K, symbol>}，而你的泛型K可能是更具体的类型（比如特定字符串字面量、symbol），TypeScript无法确认这两个类型完全等价，因此抛出类型不兼容的错误。

解决方案 #

方案1：直接类型断言（快速修复） #

既然我们明确运行时objectEntries返回的key就是原对象的K类型，直接用类型断言告诉TypeScript即可：

import { objectEntries, objectFromEntries } from 'ts-extras';

export const map = <K extends PropertyKey, V>(
    obj: Record<K, V>,
    fn: (key: K, value: V, index?: number) => [K, V]
) => {
    const entries = objectEntries(obj);
    const mappedEntries = entries.map(([key, value], index) => 
        fn(key as K, value as V, index)
    );
    return objectFromEntries(mappedEntries);
};

方案2：封装自定义类型的objectEntries（更优雅） #

把类型断言封装到自定义的objectEntries函数中，避免在业务代码里直接写断言：

import { objectEntries as tsObjectEntries, objectFromEntries } from 'ts-extras';

// 封装后保留原始key的类型
const objectEntries = <K extends PropertyKey, V>(obj: Record<K, V>): [K, V][] => 
    tsObjectEntries(obj) as [K, V][];

export const map = <K extends PropertyKey, V>(
    obj: Record<K, V>,
    fn: (key: K, value: V, index?: number) => [K, V]
) => {
    const entries = objectEntries(obj);
    const mappedEntries = entries.map(([key, value], index) => fn(key, value, index));
    return objectFromEntries(mappedEntries);
};

方案3：改用原生API（无需依赖ts-extras） #

如果项目可以移除ts-extras依赖，直接用原生Object.entries和Object.fromEntries配合类型转换：

export const map = <K extends PropertyKey, V>(
    obj: Record<K, V>,
    fn: (key: K, value: V, index?: number) => [K, V]
) => {
    const entries = Object.entries(obj) as [K, V][];
    const mappedEntries = entries.map(([key, value], index) => fn(key, value, index));
    return Object.fromEntries(mappedEntries) as Record<K, V>;
};

方案对比 #

• 方案1：代码改动最小，适合快速修复，但存在类型断言的“不严谨”（虽然运行时没问题）。
• 方案2：保持对ts-extras的依赖，同时封装了类型处理，代码更整洁。
• 方案3：摆脱第三方库依赖，原生API性能更稳定，但需要自己处理类型转换。

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