在TypeScript中，我们经常需要限制某些属性不可被修改，这时候就会用到属性只读化的能力。除了官方提供的Readonly类型，我们还可以自己实现更灵活的通用映射类型，适配不同场景的需求。
映射类型的基本原理
映射类型的核心是通过遍历已有类型的属性键，对每个属性进行一些统一的类型操作。它的基本语法结构是{ [P in keyof T]: ... }，其中P in keyof T表示遍历类型T的所有属性键，然后对每个属性进行对应的类型处理。
要实现属性只读化，我们只需要在每个属性前添加readonly修饰符即可，这是映射类型支持的基础能力。
全属性只读的通用映射类型实现
首先我们实现最基础的全属性只读映射类型，效果和官方Readonly一致，但是可以让我们更清楚原理：
// 全属性只读的通用映射类型
type MyReadonly<T> = {
readonly [P in keyof T]: T[P];
};
// 测试示例
interface User {
name: string;
age: number;
email: string;
}
type ReadonlyUser = MyReadonly<User>;
// 以下代码会报错，因为属性都是只读的
// const user: ReadonlyUser = { name: '张三', age: 20, email: 'zhangsan@ipipp.com' };
// user.name = '李四'; // 报错：Cannot assign to 'name' because it is a read-only property部分属性只读的通用映射类型实现
有时候我们不需要把所有属性都设为只读，只需要指定部分属性只读，这时候可以结合泛型参数传入需要只读的属性键：
// 部分属性只读的通用映射类型，K是T的属性键的子集
type PartialReadonly<T, K extends keyof T> = {
[P in keyof T]: P extends K ? readonly T[P] : T[P];
};
// 测试示例
interface Product {
id: number;
name: string;
price: number;
description: string;
}
// 只让id和price属性只读
type PartialReadonlyProduct = PartialReadonly<Product, 'id' | 'price'>;
const product: PartialReadonlyProduct = {
id: 1,
name: '笔记本',
price: 5000,
description: '高性能笔记本'
};
// product.id = 2; // 报错，id是只读属性
product.name = '游戏本'; // 正常，name不是只读属性深层属性只读的通用映射类型实现
如果类型中存在嵌套的对象属性，上面的映射类型只能处理第一层的属性，嵌套的属性还是可修改的。这时候我们需要实现深层递归的只读映射类型：
// 深层属性只读的通用映射类型
type DeepReadonly<T> = {
readonly [P in keyof T]: T[P] extends object ? DeepReadonly<T[P]> : T[P];
};
// 测试示例
interface Company {
name: string;
address: {
city: string;
street: string;
};
employees: {
name: string;
age: number;
}[];
}
type DeepReadonlyCompany = DeepReadonly<Company>;
const company: DeepReadonlyCompany = {
name: '某科技公司',
address: {
city: '北京',
street: '中关村大街'
},
employees: [
{ name: '张三', age: 25 }
]
};
// company.address.city = '上海'; // 报错，嵌套属性也是只读的
// company.employees[0].age = 26; // 报错，数组内的对象属性也是只读的使用注意事项
- 映射类型处理的是类型层面的操作，不会影响运行时的实际逻辑，只是编译阶段的类型约束。
- 深层只读映射类型中，我们判断
T[P] extends object来处理嵌套对象，实际使用中如果需要处理数组、函数等特殊对象类型，可以根据需求调整判断逻辑。 - 自定义的映射类型可以和TypeScript其他类型工具配合，比如结合
Pick、Omit等实现更复杂的类型转换需求。
总结
通过映射类型我们可以灵活实现TypeScript中类型属性的只读化需求，从全属性只读到部分属性只读，再到深层嵌套属性只读，都可以根据场景自定义对应的通用映射类型。掌握这些实现方法，能让我们在TypeScript开发中更精准地控制类型的可修改性，减少不必要的属性修改带来的问题。
TypeScript映射类型只读属性类型工具泛型修改时间：2026-06-02 04:57:08