OpenCode 源码解析 · 第 11 讲
OpenCode 源码解析 第 11 讲：Config 配置系统——多源合并与动态加载 基于 dev 分支源码 · 2026-07-18 一、配置系统：OpenCode 的"大脑" 前十讲覆盖了 OpenCode 从 CLI 到 MCP 的核心能力。这一讲进入 Config 配置系统 ——OpenCode 如何从 8 个不同来源加载、合并配置，支持远程配置、环境变量、OAuth 认证和 MDM 管理。配置模块横跨 14 个文件、约 1,630 行代码 。 📦 本讲核心文件 packages/opencode/src/config/config.ts （680 行）— 配置服务与合并逻辑 packages/opencode/src/config/variable.ts （91 行）— 变量替换引擎 packages/opencode/src/config/managed.ts （69 行）— macOS MDM 管理配置 packages/opencode/src/config/plugin.ts （79 行）— 插件配置加载 packages/opencode/src/config/parse.ts （79 行）— JSONC 解析与 Schema 验证 二、Config Service 架构 config/config.ts 实现了完整的配置服务，核心是 Interface 接口和 InstanceState 状态管理。配置加载支持 8 个来源，按优先级合并。 1. 配置服务接口 📄 config/config.ts (第 124-133 行) export interface Interface { readonly get: () => Effect.Effect<Info> readonly getGlobal: () => Effect.Effect<Info> readonly getConsoleState: () => Effect.Effect<ConsoleState> readonly update: (config: Info) => Effect.Effect<void> readonly updateGlobal: (config: Info) => Effect.Effect<{ info: Info; changed: boolean }> readonly invalidate: () => Effect.Effect<void> readonly directories: () => Effect.Effect<string[]> readonly waitForDependencies: () => Effect.Effect<void> } 设计亮点： 8 个公开方法覆盖了配置读取、更新、失效和依赖等待。 getGlobal 返回全局配置缓存， waitForDependencies 等待插件安装完成。 2. 配置合并策略 配置合并使用 mergeDeep 深度合并，但对数组字段使用拼接策略： 📄 config/config.ts (第 41-51 行) function mergeConfig(target: Info, source: Info): Info { return mergeDeep(target, source) as Info } function mergeConfigConcatArrays(target: Info, source: Info): Info { const merged = mergeConfig(target, source) if (target.instructions && source.instructions) { merged.instructions = Array.from( new Set([...target.instructions, ...source.instructions]) ) } return merged } 合并逻辑： 普通字段深度合并， instructions 数组拼接去重。这确保多层配置不会丢失指令。 三、8 个配置来源 OpenCode 从 8 个不同来源加载配置，按优先级从高到低合并： 1. 配置来源优先…
阅读全文：OpenCode 源码解析 第 11 讲