只读违反:修改只读属性
快速摘要
你尝试向只读数组 push 或给只读属性赋值 —— TypeScript 阻止修改只读类型。
为什么发生
ReadonlyArray 被传给尝试用 push、pop 或 splice 修改的函数
只读属性被赋新值,TypeScript 不允许
使用 Readonly<T> 类型但代码尝试将其当作可变类型修改
最小示例
✗ 错误代码
function addItem(list: ReadonlyArray<number>, item: number) {
list.push(item); // error: Property 'push' does not exist on type 'readonly number[]'
}✓ 修复代码
function addItem(list: ReadonlyArray<number>, item: number): number[] {
return [...list, item]; // non-mutating, returns new array
}使用 spread 运算符创建带添加项的新数组,避免修改只读输入数组。
如何诊断
阅读 TS 错误:'Cannot assign to readonly property' 或 'Index signature is readonly'
检查类型是否为 Readonly<T> 或 ReadonlyArray<T> 且代码尝试修改它
查找可能剥离只读修饰符的类型断言
如何修复
修改前创建可变副本:const mutable = [...readonlyArray]; mutable.push(item)
如果意图是修改则将类型改为可变(T[] 而非 ReadonlyArray<T>)
使用非修改更新模式:const updated = [...arr, item] 而非 arr.push(item)
如何预防
对不应修改的数据使用只读类型,修改前创建副本
优先使用非修改更新模式(spread、map、filter)而非就地修改
相关资源
相关术语
相关课程
- 只读类型
学习只读。