Skip to content

只读违反:修改只读属性

快速摘要

你尝试向只读数组 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)而非就地修改

相关资源

相关术语

相关课程

← 返回语言