在TypeScript中使用Immutable转换嵌套数据为不可变结构时如何解决类型不匹配？

问题原因 #

Immutable.js 的 fromJS 方法会将普通 JavaScript 对象转换为 Map，数组转换为 List。你定义的 Data 是普通对象类型，但 fromJS(arr) 返回的是 Immutable 集合类型（List<Map<keyof Data, string | List<Map<"field1", string>>>>），二者结构完全不同，因此触发类型不兼容的编译错误。

修复方案 #

方案1：定义匹配Immutable结构的类型 #

为转换后的Immutable结构专门定义类型，让类型系统正确识别：

import { List, Map, fromJS } from 'immutable';

type SubData = {
    field1: string;
}

type Data = {
    field0: string;
    subData: SubData[];
};

// 定义Immutable版本的对应类型
type ImmutableSubData = Map<keyof SubData, string>;
type ImmutableData = Map<keyof Data, string | List<ImmutableSubData>>;

const arr: Data[] = [];

// 使用正确的Immutable类型声明
const list: List<ImmutableData> = fromJS(arr);

方案2：使用Record创建强类型不可变对象 #

如果希望Immutable结构更贴近普通对象的属性访问体验（比如用.直接获取属性），可以用Record定义强类型不可变记录，替代fromJS的自动转换：

import { List, Record } from 'immutable';

type SubData = {
    field1: string;
}

// 定义Data类型时，subData指定为Immutable List类型
type Data = {
    field0: string;
    subData: List<ReturnType<typeof SubDataRecord>>;
};

// 创建SubData的Record模板
const SubDataRecord = Record<SubData>({ field1: '' });
// 创建Data的Record模板，初始化默认值
const DataRecord = Record<Data>({ field0: '', subData: List() });

// 用Record构建实例数组
const arr = [
  DataRecord({
    field0: 'demo',
    subData: List([SubDataRecord({ field1: 'sub-demo' })])
  })
];

// 直接将数组转为Immutable List，类型自动匹配
const list = List(arr);

方案3：类型断言（仅临时应急，不推荐） #

若你能确保转换后的结构与Data完全一致，可通过类型断言强制转换，但这会绕过TypeScript的类型检查，存在潜在风险：

import { List, fromJS } from 'immutable';

type SubData = {
    field1: string;
}

type Data = {
    field0: string;
    subData: SubData[];
};

const arr: Data[] = [];

// 先转为unknown再转目标类型，避免直接断言的类型冲突
const list = fromJS(arr) as unknown as List<Data>;

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