深度冻结需递归处理嵌套对象与数组，跳过原始值、null、undefined及Date/RegExp等内置对象，用WeakMap防循环引用，并配合TypeScript readonly与开发约定实现真正不可变。
Object.freeze() 本身只做浅冻结，要真正保护全局状态机不被意外修改，必须递归冻结所有嵌套对象和数组。关键在于：跳过原始值、避免循环引用、正确处理数组与类实例。
识别并跳过不可冻结的值
不是所有值都能被 freeze。需要先过滤掉 null、undefined、原始类型（string/number/boolean/symbol/bigint）以及 Date、RegExp、Promise 等内置对象——它们要么无意义冻结，要么会报错或静默失败。
- 用 Object.prototype.toString.call(val) 精确判断类型，比 typeof 更可靠
- 对 val instanceof Object && val !== null 的值才考虑冻结
- 特别排除 Date、RegExp、Map、Set、ArrayBuffer 等非普通对象（它们冻结无效或无实际防护作用）
手动处理数组与普通对象
数组是对象，但需单独处理：先冻结自身，再遍历每一项递归冻结；普通对象则遍历自有属性（不包括原型链），逐个冻结其值。
- 对数组：调用 Object.freeze(arr) 后，用 arr.forEach(freezeDeep)
- 对普通对象：用 Object.getOwnPropertyNames(obj) 获取所有自有属性名，再对每个 obj[key] 递归调用
- 注意：Object.keys() 会忽略不可枚举属性，而 getOwnPropertyNames 更全面
防止循环引用导致栈溢出
若状态树中存在自引用或环状结构（如父子双向引用），直接递归会无限深入。需维护一个 WeakMap 缓存已处理对象的引用。
PigX UI 前端开发
下载
PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。
立即学习“前端免费学习笔记（深入）”；
- 初始化一个 const seen = new WeakMap()，键为对象，值为冻结后的结果
- 每次进入函数时先查 seen.has(obj)，若有则直接返回缓存值
- 冻结前调用 seen.set(obj, frozen)，确保同一对象只冻结一次
冻结后仍需配合开发约束
深度冻结不能替代设计规范。即使状态被完全冻结，开发者仍可能通过替换整个属性绕过防护（如 state.user = {...}）。
- 建议将冻结逻辑封装为 freezeState(state) 工厂函数，在创建状态机时统一调用
- 搭配 TypeScript 的 readonly 类型提示，从编译期提醒不可变意图
- 在 Redux 或 Zustand 等库中，冻结应放在 reducer 返回前或 store 初始化阶段，而非运行时反复调用
不复杂但容易忽略：真正的“不可变”靠的是组合策略——冻结 + 类型系统 + 开发约定 + 工具链检查（如 eslint-plugin-immutable）。
