Object.assign合并配置及属性覆盖详解

本文深入解析了 JavaScript 中 Object.assign 方法在配置对象合并中的核心机制与常见陷阱，重点揭示其浅拷贝本质——仅逐层复制可枚举自有属性，同名属性后写入者无条件覆盖前者，嵌套对象整引用替换而非深度合并；通过默认配置与用户配置的典型示例，直观展现 api 等深层属性意外丢失的原因，并给出安全实践建议：始终用空对象作目标、慎用数组、深合并需借助递归方案或工具库，助你避开生产环境中的隐蔽坑点。

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。

典型配置合并示例

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

<code>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' } }
</code>

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

安全使用建议

• 始终把空对象 {} 作为第一个参数，避免意外修改原始配置；
• 如需深合并嵌套结构（如 api 内部也要合并），应使用 structuredClone + 递归合并，或借助 Lodash 的 merge；
• 不要依赖 Object.assign 处理数组：它把数组当对象处理，索引变成属性名，可能产生非预期结果；
• 在 TypeScript 中，注意类型推导可能不够精确（尤其多 source 场景），必要时手动标注返回类型。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~