JavaScript浅拷贝合并配置项默认值的核心是用Object.assign()或展开运算符实现顶层键覆盖，生成新对象而不修改默认配置，嵌套对象不深合并。

JavaScript 中浅拷贝实现配置项默认值合并，核心是用一个简单、安全的方式把用户传入的配置覆盖到默认配置上，同时不修改默认对象本身。常用方法有 Object.assign()、展开运算符（{...}）或手动遍历赋值，都属于浅拷贝 —— 即只复制第一层属性，嵌套对象仍共享引用。

用 Object.assign() 合并默认值

这是最常见也最稳妥的浅拷贝合并方式。它不会改变原默认对象，而是返回一个新对象：

const defaults = {
  timeout: 5000,
  retries: 3,
  headers: { 'Content-Type': 'application/json' }
};

const userConfig = {
  timeout: 3000,
  headers: { 'Authorization': 'Bearer abc' }
};

// 合并：defaults 不变，返回新对象
const config = Object.assign({}, defaults, userConfig);
// → { timeout: 3000, retries: 3, headers: { 'Authorization': 'Bearer abc' } }

注意：headers 被整个替换了，不是深合并 —— 原来的 'Content-Type' 丢失了。这是浅拷贝的典型表现，符合“默认值 + 覆盖”语义，通常正是你想要的。

用展开运算符（...）更简洁

ES6+ 推荐写法，语义清晰，同样只做浅拷贝：

立即学习“Java免费学习笔记（深入）”；

const config = {
  ...defaults,
  ...userConfig
};

执行顺序从左到右，后出现的同名属性会覆盖前面的。和 Object.assign() 行为一致，且代码更轻量。

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

避免直接修改 defaults 的坑

以下写法是错误的，会污染默认配置：

// ❌ 危险！修改了 defaults
Object.assign(defaults, userConfig);

// ❌ 同样危险！
defaults = { ...defaults, ...userConfig }; // 只是重赋值变量，若 defaults 是 const 则报错

正确做法始终以空对象 {} 或新字面量为第一个参数，确保生成全新对象。

处理 undefined 或 null 配置

用户可能传 null 或 undefined，需提前兜底：

function createConfig(userConfig = {}) {
  return {
    ...defaults,
    ...((userConfig && typeof userConfig === 'object') ? userConfig : {})
  };
}

或者更简练地用空对象 fallback：

const config = {
  ...defaults,
  ...(userConfig || {})
};

这样即使 userConfig 是 null、undefined 或 false，也不会报错。

不复杂但容易忽略的是：浅拷贝合并默认值，本质是「顶层键覆盖」，不是递归合并。如果需要嵌套字段也合并（如 headers 里保留默认 + 新增），就得用深拷贝或专用工具（如 Lodash 的 _.defaultsDeep），但那已不属于浅拷贝范畴了。