浅拷贝是默认配置合并首选，因它仅顶层覆盖、不递归嵌套，快且可控；如弹窗组件中用户只改width和title，其余如animation和headers原样保留；标准写法为Object.assign({}, defaults, userConfig)或{...defaults, ...userConfig}，避免污染源对象。
浅拷贝在合并默认配置与用户自定义配置时，核心是用 Object.assign() 或展开运算符（{...}）做顶层属性的覆盖式合并——它不深入嵌套结构，但正因“浅”，才快、可控、不易出错。
为什么默认配置合并首选浅拷贝
大多数配置场景只要求“用户传什么就改什么，其余保持默认”，不需要递归处理嵌套字段。比如弹窗组件：
- 默认有
{ width: 400, title: '提示', animation: true, headers: { 'Content-Type': 'application/json' } } - 用户只传
{ width: 600, title: '确认操作' } - 你期望结果是保留
animation和整个headers对象，只替换显式指定的字段
这正是浅拷贝的天然优势：它按属性名一层覆盖，不碰未提及的键，也不试图“拆开” headers 去合并内部字段。
标准写法：用空对象作目标，避免污染原配置
推荐始终把第一个参数设为空对象 {}，防止意外修改默认配置或用户配置：
-
正确：
const final = Object.assign({}, defaults, userConfig); -
错误（危险）：
const final = Object.assign(defaults, userConfig);—— 这会直接改掉defaults，后续调用全受影响
展开运算符写法更简洁，语义相同：const final = { ...defaults, ...userConfig };
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
注意嵌套对象会被整体替换，不是“合并”
这是最容易踩坑的地方：如果 defaults 和 userConfig 都有 api 字段，且都是对象，那么 userConfig.api 会**完全取代** defaults.api，而不是把两个 api 里的字段逐个合并。
- 例如：
defaults = { api: { timeout: 5000, baseUrl: '/v1' } }，userConfig = { api: { timeout: 3000 } } - 结果：
final.api === { timeout: 3000 }，baseUrl消失了
解决方法有两个方向：
- 设计上扁平化：把
api_timeout、api_baseUrl拆成顶层键，避开嵌套 - 逻辑上分层处理：先单独合并
api层（用Object.assign({}, defaults.api, userConfig.api)），再组装进最终对象
多级优先级配置也适用浅拷贝
实际项目常有“默认配置 ← 环境配置 ← 用户配置”三级，优先级从左到右递增。浅拷贝天然支持这种链式覆盖：
const config = Object.assign({}, defaults, envConfig, userConfig);- 后出现的对象中同名属性，会依次覆盖前面的值
- 比如
envConfig设了timeout: 3000，userConfig又设了timeout: 1500，最终就是1500
只要各层级都遵循“只覆盖必要字段”的原则，浅拷贝就能干净利落地完成整套配置融合。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
