怎么用 Object.assign 实现配置对象的浅合并并理解其属性覆盖规则

作者：袖梨 2026-07-21

Object.assign 是 JavaScript 中用于浅拷贝和对象合并的内置方法，按顺序将多个源对象的可枚举自有属性复制到目标对象并返回该对象；它不递归处理嵌套对象，同名属性后写入者覆盖前者，仅复制可枚举自有属性，不处理原型、getter/setter 或不可枚举属性。

Object.assign 是 JavaScript 中用于浅拷贝和合并对象的内置方法，它按顺序将一个或多个源对象的可枚举自有属性复制到目标对象，并返回目标对象。它不递归处理嵌套对象，只做一层属性赋值，因此属于浅合并。

基本用法与浅合并特性

调用形式为 Object.assign(target, ...sources)，其中：

target 是第一个参数，也是被修改并返回的对象；
sources 可以有多个，从左到右依次遍历其可枚举自有属性；
遇到同名属性时，后出现的 source 会覆盖先出现的（包括 target 自身已有属性）；
只复制 可枚举且自有 的属性（不处理 getter/setter、不可枚举属性、原型链上的属性）。

属性覆盖规则详解

覆盖行为由“赋值”语义决定，不是“深合并”，也不区分数据类型：

如果 target 已有属性 a: 1，后续 source 提供 a: 'hello'，则 a 被覆盖为字符串；
如果 source 提供 obj: { x: 1 }，而 target 中 obj 原为 { y: 2 }，则整个 obj 引用被替换，不会合并内部属性；
若某 source 属性值为 undefined，仍会触发赋值（即 target 对应属性变为 undefined）；
null 或 undefined 作为 source 会被跳过（不报错），但作为 target 会抛出 TypeError。

典型配置合并示例

常用于设置默认配置 + 用户配置：

const defaults = { theme: 'light', timeout: 5000, api: { baseUrl: '/v1' } };const userConfig = { theme: 'dark', debug: true, api: { version: 'beta' } };const finalConfig = Object.assign({}, defaults, userConfig);// → { theme: 'dark', timeout: 5000, debug: true, api: { version: 'beta' } }

注意：api 整个被替换成新对象，defaults.api.baseUrl 丢失——这就是浅合并的关键限制。