深拷贝无法复制不可枚举属性,因其普遍依赖Object.keys()或for...in遍历,而二者均跳过enumerable: false的属性;需改用Reflect.ownKeys()结合Object.getOwnPropertyDescriptor()和Object.defineProperty()手动重建。

JavaScript 中深拷贝无法复制不可枚举属性,根本原因是大多数深拷贝实现(如 JSON.parse(JSON.stringify())、Lodash 的 _.cloneDeep 默认行为、或手写递归遍历)依赖 for...in、Object.keys() 或 Reflect.ownKeys() 的组合,而这些方法对不可枚举属性的处理方式不同——尤其 Object.keys() 和 for...in 会跳过不可枚举属性,导致它们在拷贝过程中被静默丢弃。
明确哪些属性属于“不可枚举”
不可枚举属性是通过 Object.defineProperty 显式设置 enumerable: false 创建的,或原生对象上某些内置属性(如 Array.prototype.length、Function.prototype.name)。它们不会出现在 for...in、Object.keys() 中,但可通过 Object.getOwnPropertyNames() 或 Reflect.ownKeys() 获取。
-
Object.keys(obj)→ 只返回可枚举的自有属性键 -
Object.getOwnPropertyNames(obj)→ 返回所有自有属性键(含不可枚举) -
Reflect.ownKeys(obj)→ 同上,还包含 Symbol 键
检查你用的深拷贝方案是否覆盖不可枚举属性
常见方案的行为差异:
-
JSON.parse(JSON.stringify(obj)):完全忽略不可枚举属性、Symbol、函数、undefined、Date、RegExp 等,仅处理可枚举的原始值和普通对象/数组 - Lodash
_.cloneDeep:默认不复制不可枚举属性,因为它内部基于Object.keys()遍历;但可通过自定义customizer钩子 +Object.getOwnPropertyDescriptors()手动处理 - 手写递归深拷贝:若只用
for...in或Object.keys(),就会漏掉;应改用Reflect.ownKeys()并结合Object.getOwnPropertyDescriptor()读取完整属性描述符
修复方法:手动保留不可枚举属性
核心思路是:不用 Object.keys(),改用 Reflect.ownKeys() 获取全部键(包括不可枚举和 Symbol),再用 Object.getOwnPropertyDescriptor() 提取每个属性的完整配置(value、writable、enumerable、configurable),最后用 Object.defineProperty() 在新对象上重建。
立即学习“Java免费学习笔记(深入)”;
Java项目代码review工具。分析Git变更+完整调用链路上下文,推断业务需求,进行多维度评分和分类汇总,生成完整PRD文档。包含细粒度Java代码审查清单(Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
示例(简化版深拷贝,支持不可枚举属性和 Symbol):
function deepCloneWithNonEnumerable(obj) {
if (obj === null || typeof obj !== 'object') return obj;
const cloned = Array.isArray(obj) ? [] : {};
// 获取所有自有键:字符串 + Symbol
const keys = Reflect.ownKeys(obj);
for (const key of keys) {
const desc = Object.getOwnPropertyDescriptor(obj, key);
const value = desc.value;
// 递归拷贝值(简单起见,此处未处理循环引用)
const clonedValue = (value !== null && typeof value === 'object')
? deepCloneWithNonEnumerable(value)
: value;
// 保持原始 descriptor,仅更新 value(其他元信息如 enumerable/writable 保持不变)
Object.defineProperty(cloned, key, {
...desc,
value: clonedValue
});
}
return cloned;
}
注意:此方案仍需额外处理 Date、RegExp、Map、Set、函数等特殊类型,且要防范循环引用;生产环境建议在 Lodash 基础上扩展,或使用 structuredClone(现代浏览器支持,原生支持不可枚举属性、Symbol、Map/Set 等,但暂不支持函数和 RegExp)。
快速验证是否成功复制了不可枚举属性
用 Object.getOwnPropertyDescriptors() 对比源对象和克隆对象的完整描述符:
const src = {};
Object.defineProperty(src, 'hidden', {
value: 42,
enumerable: false,
writable: true,
configurable: true
});
const copy = deepCloneWithNonEnumerable(src);
console.log(Object.getOwnPropertyDescriptors(src));
console.log(Object.getOwnPropertyDescriptors(copy));
// 两者输出应一致,包括 hidden 的 enumerable: false
如果 copy 中没有 hidden 字段,或其 enumerable 变为 true,说明拷贝逻辑未正确保留 descriptor。

















