TypeScript双向映射类构造时Object.entries赋值Map的类型错误排查

错误原因 #

你遇到的类型错误核心在于Object.entries()的类型设计限制：

• TypeScript 中，Object.entries()的返回类型固定为[string, T][]，无论原对象的键声明为string、number还是更具体的字面量类型。这是因为 JavaScript 运行时会把对象的所有键转换为字符串（比如数字键1会被转为"1"），所以 TypeScript 类型系统做了保守处理，不会保留键的原始精确类型。
• 你的类中map的类型是Map<K, V>，其中K是string|number的子类型（比如可能是'a'|'b'这种字面量类型）。用Object.entries(obj)创建的Map类型是Map<string, V>，而string无法赋值给更具体的K类型，因此触发类型不匹配错误。

修复方案 #

方案1：类型断言（简洁直接） #

由于构造函数参数已经约束为{ [key in K]: V }，我们可以明确断言Object.entries(obj)的返回类型为[K, V][]，让 TypeScript 认可键的类型：

class TwoWayMap<K extends string|number, V extends string|number> {
    private map: Map<K, V>;
    private reverseMap: Map<V, K>;
    constructor(obj: { [key in K]: V }) {
        // 添加类型断言
        this.map = new Map(Object.entries(obj) as [K, V][]);
        this.reverseMap = new Map<V, K>();
        for (let [key, val] of this.map) {
            this.reverseMap.set(val, key);
        }
    }
    public get(key: K): V | undefined { return this.getFromKey(key); }
    public getFromKey(key: K): V | undefined { return this.map.get(key); }
    public getFromVal(val: V): K | undefined { return this.reverseMap.get(val); }
}

方案2：手动遍历构建Map（类型更安全） #

避开Object.entries()的类型限制，手动遍历对象键并转换类型，这种方式能更精准地控制类型：

class TwoWayMap<K extends string|number, V extends string|number> {
    private map: Map<K, V>;
    private reverseMap: Map<V, K>;
    constructor(obj: { [key in K]: V }) {
        this.map = new Map();
        this.reverseMap = new Map();
        // 手动遍历并处理键类型
        for (const key in obj) {
            if (Object.prototype.hasOwnProperty.call(obj, key)) {
                const value = obj[key];
                this.map.set(key as K, value);
                this.reverseMap.set(value, key as K);
            }
        }
    }
    public get(key: K): V | undefined { return this.getFromKey(key); }
    public getFromKey(key: K): V | undefined { return this.map.get(key); }
    public getFromVal(val: V): K | undefined { return this.reverseMap.get(val); }
}

两种方案都能解决类型错误，方案1更简洁，方案2避免了类型断言，在类型安全上更严谨。

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