浅拷贝默认跳过不可枚举属性,需用Object.getOwnPropertyDescriptors获取全部自有属性描述符,再通过Object.defineProperties重建对象以保留enumerable、writable、configurable及getter/setter等元信息。

浅拷贝默认会跳过不可枚举属性,比如用 {...obj} 或 Object.assign({}, obj) 都无法保留 enumerable: false 的字段。要安全复制包含不可枚举属性的对象,必须绕过“可枚举性”这个过滤条件,直接读取并重建所有自有属性描述符。
用 getOwnPropertyDescriptors 捕获全部自有属性定义
Object.getOwnPropertyDescriptors(obj) 能一次性获取对象所有自有属性(包括字符串键和 Symbol 键)的完整描述符,无论 enumerable 是 true 还是 false。它返回一个键为属性名、值为 descriptor 对象的普通对象,天然保留了 writable、configurable、enumerable、get、set 和 value 等元信息。
- 它不依赖遍历逻辑,因此不受
for...in或Object.keys()的可枚举限制 - 能同时捕获 Symbol 属性(
Object.getOwnPropertySymbols()的结果已隐含在 descriptors 中) - 对 getter/setter、只读属性、不可配置属性等行为型描述符也原样提取
用 defineProperties 重建目标对象
拿到 descriptors 后,不能简单赋值或展开,而要用 Object.defineProperties(target, descriptors) 将每个描述符逐个安装到新对象上。这样能确保:
- 不可枚举属性在副本中仍保持
enumerable: false - getter/setter 函数体被完整复用,且
this绑定指向新对象(前提是新对象结构兼容) - 只读(
writable: false)和不可配置(configurable: false)状态被严格继承
注意边界:这不是深拷贝,也不处理原型
该方式仅复制对象自身的属性定义,不涉及原型链、不递归处理嵌套对象值:
用于 inference.sh 的 JavaScript/TypeScript SDK,可运行 AI 应用、构建代理、集成 150+ 模型。包名:@inferencesh/sdk(npm install),完整 TypeScript 支持。
- 如果某个属性值是对象,副本里仍是同一引用——这是浅拷贝的本质,不是缺陷
- 原型上的属性(哪怕不可枚举)不会被
getOwnPropertyDescriptors获取,因此不会出现在副本中 - Symbol 键会被保留,但若业务需要“净化”,可先过滤掉 Symbol 属性再传入
defineProperties
一个稳妥的封装写法
把上述逻辑封装成函数,兼顾健壮性和可读性:
function shallowCopyWithNonEnumerable(obj) {
if (obj == null || typeof obj !== 'object') return obj;
return Object.defineProperties({}, Object.getOwnPropertyDescriptors(obj));
}
调用后,副本与原对象在属性行为层面完全一致:不可枚举属性可用 in 操作符检测、getOwnPropertyDescriptor 查看、hasOwnProperty 判断存在性,但不会出现在 Object.keys() 或 JSON.stringify() 结果中。

















