首选 structuredClone(需检测兼容性),其次 JSON.parse(JSON.stringify()) 仅限纯数据,手写递归需防循环引用和类型误判,lodash.cloneDeep 要按需引入并注意 nvue 不支持。

uni-app里直接用 structuredClone 最省事
如果你的 uni-app 项目运行在微信小程序基础库 2.28.0+(对应微信客户端 8.0.47+)、支付宝小程序、或 H5 环境(Chrome 98+/Firefox 94+/Safari 15.4+),structuredClone 是首选。它原生支持 Date、RegExp、Map、Set、ArrayBuffer,还能安全处理循环引用。
但注意:微信小程序真机上 structuredClone 在 iOS 微信中直到 8.0.49 才稳定启用;Android 端部分低版本仍可能抛 ReferenceError: structuredClone is not defined。所以必须加兜底:
- 先
typeof structuredClone === 'function'检测可用性 - 不可用时降级到
JSON.parse(JSON.stringify(obj))(仅限纯数据)或手写递归方案 - 不要在条件编译里硬切,因为不同平台基础库版本碎片化严重
JSON.parse(JSON.stringify()) 在 uni-app 里能用但很脆
这个组合在 uni-app 的 H5 和小程序开发工具里跑得通,但上线后容易出问题:
-
undefined、function、Symbol属性直接消失,不报错也不提醒 -
new Date()变成字符串,/abc/g变成空对象{} - 如果对象里有
uni.getSystemInfoSync()返回的某些字段(比如safeArea中的top是 number,但某些安卓机型返回的是 string + 单位),序列化后类型可能被隐式转换 - 遇到循环引用(比如 Vue 组件实例里带
$parent、$refs)直接卡死或报Converting circular structure to JSON
只建议用于临时调试或明确知道源对象是「纯 JSON 数据」的场景,比如从 API 拿到的配置项、商品列表响应体。
立即学习“Java免费学习笔记(深入)”;
手写递归深拷贝要防住 WeakMap 和类型分支
uni-app 运行在多端,不能依赖 Node.js 的 util.inspect 或浏览器专属 API,所以手写时必须自己判断类型并隔离循环引用:
- 用
Object.prototype.toString.call(obj)判断Date、RegExp、Array、Map、Set,别只靠instanceof(跨 iframe 或某些小程序环境会失效) - 必须传入
WeakMap缓存已拷贝对象,否则遇到obj.a = obj这类结构立即栈溢出 -
Map和Set需要遍历键值对重建,不能只用new Map(obj)(那只是浅拷贝) - 避免递归调用时把
null当成Object处理——typeof null === 'object'是历史 bug,得单独obj === null判断
示例关键逻辑片段:
function deepClone(obj, hash = new WeakMap()) {
if (obj === null || typeof obj !== 'object') return obj;
if (hash.has(obj)) return hash.get(obj);
let cloned;
const typeStr = Object.prototype.toString.call(obj);
if (typeStr === '[object Date]') return new Date(obj);
if (typeStr === '[object RegExp]') return new RegExp(obj);
if (typeStr === '[object Array]') cloned = [];
else if (typeStr === '[object Object]') cloned = {};
else if (typeStr === '[object Map]') cloned = new Map();
else if (typeStr === '[object Set]') cloned = new Set();
else return obj; // 其他类型如 Blob、File 不处理,原样返回
hash.set(obj, cloned);
if (Array.isArray(obj)) {
for (let i = 0; i < obj.length; i++) {
cloned[i] = deepClone(obj[i], hash);
}
} else if (obj instanceof Map) {
obj.forEach((v, k) => cloned.set(k, deepClone(v, hash)));
} else if (obj instanceof Set) {
obj.forEach(v => cloned.add(deepClone(v, hash)));
} else {
for (let key in obj) {
if (obj.hasOwnProperty(key)) {
cloned[key] = deepClone(obj[key], hash);
}
}
}
return cloned;
}
用 lodash.cloneDeep 要小心包体积和 tree-shaking
uni-app 默认使用 webpack,lodash 全量引入会增加几十 KB 包体积。虽然 cloneDeep 功能最全(支持 function 序列化、自定义克隆逻辑、undefined 保留等),但在小程序里往往用不到那么重的能力。
- 推荐改用
lodash-es并按需导入:import cloneDeep from 'lodash-es/cloneDeep'; - 确保
babel-plugin-lodash或lodash-webpack-plugin配置正确,否则 tree-shaking 失效 - 注意:uni-app 的 nvue 页面不支持
lodash(因为不走 JS 引擎,走原生渲染),只能在 vue 页面中使用 - 如果只是表单编辑页需要隔离原始数据,更轻量的做法是:在
onLoad时深拷贝一次,后续所有修改都基于该副本,不再反复拷贝
真正麻烦的不是“怎么拷”,而是“什么时候不该拷”——比如在 watch 或 computed 里高频调用深拷贝,或者对整个 this.$store.state 做无差别克隆,这些都会直接拖慢页面响应。深拷贝永远是防御性操作,不是默认行为。


















