配置分层与默认值
合并默认值、文件和环境变量覆盖项。
配置分层与默认值 是 CoddyKit 上的免费 TypeScript Academy 课时。 这是第 3 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 TypeScript Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 TypeScript Academy 课程共包含 4 节课。
分层配置
实际应用会从多个来源组装 config：内置的 defaults、配置文件以及环境覆盖项。后面的层会按照既定的优先级顺序覆盖前面的层。
优先级顺序
一种常见的顺序是从最低到最高：defaults < 文件配置 < 环境变量。环境覆盖项具有最高优先级，因为它们适合进行针对每次部署的调整。
定义各层
每一层都是部分配置。只有基础 defaults 需要完整；其他层只需填充或覆盖选定字段。
interface Config { port: number; host: string; logLevel: string; }
const defaults: Config = { port: 3000, host: "localhost", logLevel: "info" };部分覆盖
文件层和 env 层的类型是 Partial<Config>，因为它们可能只指定部分键。将它们声明为部分配置，正好反映了任何字段都可能缺失这一点。
const fileConfig: Partial<Config> = { port: 8080 };
const envConfig: Partial<Config> = { logLevel: "debug" };浅层合并
对于扁平配置，使用展开运算符进行合并即可清晰地应用优先级。后面的对象会覆盖前面的键，从而生成最终配置。
const config: Config = { ...defaults, ...fileConfig, ...envConfig };
// { port: 8080, host: "localhost", logLevel: "debug" }顺序为何重要
由于展开运算符遵循后者优先，最后列出的来源具有最高优先级。重新排列展开顺序，就会改变各层之间的覆盖关系。
嵌套配置需要深度合并
浅层展开会替换整个嵌套对象。如果 config 包含嵌套部分，就需要进行深度合并，递归地组合这些部分，而不是直接覆盖它们。
interface Config { db: { host: string; port: number }; }
// { ...a, ...b } would replace the entire db object, losing keys.类型化的深度合并
递归合并会遍历两个对象，深入嵌套记录并覆盖叶节点。要为结果添加类型，需要一个递归类型辅助工具。
type DeepPartial<T> = { [K in keyof T]?: DeepPartial<T[K]> };
function deepMerge<T>(base: T, over: DeepPartial<T>): T {
const out: any = { ...base };
for (const k in over) {
const v = (over as any)[k];
out[k] = v && typeof v === "object" ? deepMerge((base as any)[k], v) : v;
}
return out;
}用于覆盖层的 DeepPartial
覆盖层的类型是 DeepPartial<Config>，因此它们可以指定嵌套键的任意子集，同时仍会根据完整结构进行类型检查。
const override: DeepPartial<Config> = { db: { port: 5433 } };
// merges into db without dropping db.host结合验证
先进行合并，再使用模式验证结果。这样，被检查正确性的对象就是最终的完整配置。
// const merged = deepMerge(defaults, override);
// const config = ConfigSchema.parse(merged);分层的最佳实践
保持 defaults 完整且安全，让文件表达特定于环境的设置，并将 env 变量保留给密钥和优先级链顶端的每次部署覆盖项。
快速检查
快速检查本课内容。
回顾
分层 config 按优先级顺序合并 defaults、文件配置和 env 覆盖项（defaults < 文件 < env）。扁平配置使用展开运算符；嵌套配置需要使用 DeepPartial<Config> 进行类型化的深度合并。请验证合并后的结果。
常见问题解答
「配置分层与默认值」课时是免费的吗？
是的 — 「配置分层与默认值」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 TypeScript Academy 课程的其余内容，请升级到 CoddyKit PRO。 TypeScript Academy 课程共包含 4 节课。
「配置分层与默认值」这节课中我会学到什么？
合并默认值、文件和环境变量覆盖项。 你通过在浏览器中直接运行的动手代码来练习 TypeScript Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 TypeScript Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 TypeScript Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 3 节课，共 4 节。
「配置分层与默认值」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 TypeScript Academy 课中编写并运行代码吗？
能。每节 TypeScript Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。