深拷贝是保障“禁止直接修改原始状态”规范落地的关键技术手段；团队须对全局状态对象、含嵌套结构的props/参数、需历史快照的数据强制深拷贝，并统一使用structuredclone或lodash.clonedeep等安全方法。
深拷贝本身不是规范，而是支撑规范落地的技术手段。团队数据修改规范的核心是“禁止直接修改原始状态”，而深拷贝是实现这一原则的关键保障。
明确哪些数据必须深拷贝
不是所有对象都需要深拷贝。团队应约定以下三类数据在使用前必须深拷贝：
- 全局状态对象：如 Redux/Vuex store 中的 state、Pinia 的 $state、或自定义的 sharedConfig
- 传入组件/函数的 props 或参数：尤其当该对象含嵌套结构（如 user.profile.address）且后续可能被修改时
- 需要保留历史快照的数据：例如表单编辑前的原始值、撤销栈中的上一状态、API 响应缓存副本
统一选用现代、安全的深拷贝方法
避免团队成员各自用 JSON.parse(JSON.stringify())、手写递归或第三方库混用。推荐按环境分级采用：
Java Development Manual
下载
Java开发手册规约集合，基于阿里巴巴Java开发手册（嵩山版）。 涵盖7大维度：编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。 当用户需要：(1) 编写或审查Java代码 (2) 检查命名/代码规范 (3) 处理异常和日志 (4) 编写单元测试 (5) 安全编码 (6) 数据库设...
-
现代浏览器环境（2025+ 主流版本）：强制使用
structuredClone()—— 它原生支持 Map、Set、Date、RegExp、ArrayBuffer 及循环引用，无数据丢失风险 -
需兼容旧版浏览器（如 IE11 或部分 Electron）：统一引入
lodash.cloneDeep，并禁用JSON.stringify方式（因其会静默丢弃 function、undefined、Symbol、BigInt 等） -
Node.js 环境（v17.0+）：同样优先
structuredClone()；v16 及以下可封装 polyfill 或使用node:util的structuredClone（若可用）
在代码审查中加入硬性检查项
将深拷贝要求写入团队 Code Review Checklist，并通过工具辅助拦截：
- 禁止对非基本类型变量直接赋值后修改，如
const tmp = obj; tmp.name = 'x'→ 必须先 clone - 禁止在 useEffect / onMounted / computed 等响应式副作用中直接修改 props 或 store.state
- ESLint 插件可配置规则：检测
obj.x =类赋值前是否调用过structuredClone、cloneDeep或已知安全工厂函数（如createUserSnapshot()）
封装受控的克隆工具函数
不鼓励每个人重复写深拷贝逻辑。建议在 utils/data.js 中提供语义化工具：
-
safeClone(data)：内部自动判断环境，降级调用structuredClone或lodash.cloneDeep -
shallowFreeze(obj)：开发环境对传入对象调用Object.freeze（仅顶层），快速暴露意外修改 -
assertCloned(original, cloned)：测试辅助函数，验证两对象内存地址不同、且深层属性值一致（用于单元测试断言）
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
