JavaScript批量将对象所有属性设为只读

时间：2026-07-15 18:52

使用Object freeze()可冻结对象顶层属性，但无法递归处理嵌套对象。深层冻结需手动递归遍历子对象。Object defineProperty配合Object keys()或getOwnPropertyNames()实现更细粒度的只读设置。注意不可枚举属性、Proxy及Map等内置集合的内部状态无法被冻结。

先说结论：如果需要将对象的所有自有属性快速设置为只读，直接使用 Object.freeze() 是最简便的方法。但需要注意，这个方法只作用于当前层级，不会递归处理嵌套对象——换言之，只能冻结浅层结构。

Ja vaScript 中如何批量将对象所有属性设置为只读

下面我们详细拆解几种实现方式，并梳理一些容易忽略的坑点。

基础用法：冻结顶层对象

Object.freeze() 是最直接的方案，适用于简单的扁平对象。调用后，对象属性的 writable、configurable、enumerable 描述符都会被锁定。尝试修改属性值、新增属性或删除已有属性？在非严格模式下会静默失败，严格模式下直接抛出错误——行为非常明确。

但要记住：它只处理对象自身的属性，不会影响原型链中的属性。来看一个示例：

const obj = { a: 1, b: 2 };
Object.freeze(obj);
obj.a = 99;      // 无声无息
obj.c = 3;       // 添加失败
delete obj.b;    // 删除失败
console.log(obj); // { a: 1, b: 2 }

深层冻结：递归处理嵌套对象

当遇到嵌套对象时，例如对象内部包含子对象或数组，就需要手动递归冻结。大致思路是：先判断当前值是否为普通对象或数组（需排除 null、基本类型、Date、RegExp 等），然后对每个可遍历的自有属性递归调用冻结函数，最后再冻结当前层。

一个简洁的实现如下：

function deepFreeze(obj) {
  if (obj && typeof obj === 'object' && !Object.isFrozen(obj)) {
    Object.getOwnPropertyNames(obj).forEach(prop => {
      if (obj[prop] !== null && typeof obj[prop] === 'object') {
        deepFreeze(obj[prop]);
      }
    });
    Object.freeze(obj);
  }
  return obj;
}

使用时直接调用 deepFreeze({ a: 1, nested: { x: 2 } })，这样 nested.x 也会变得不可修改。

替代方案：用 Object.defineProperty 实现批量设置

如果希望获得更精细的控制——例如只将 writable 设为 false，但保留 configurable 为 true——那么 Object.freeze() 就略显僵硬。此时可以借助 Object.defineProperty 配合 Object.keys() 逐属性设置。

注意：Object.keys() 仅处理可枚举属性；若要覆盖不可枚举属性，则需使用 Object.getOwnPropertyNames()。下面的函数可以做到：

function makeAllReadOnly(obj) {
  Object.getOwnPropertyNames(obj).forEach(key => {
    Object.defineProperty(obj, key, {
      writable: false,
      configurable: false,
      enumerable: true // 保持原有枚举性
    });
  });
  return obj;
}