OpenCode 源码解析 · 第 15 讲
OpenCode 源码解析 第 15 讲：Env 与运行时标志——环境变量、Flag 系统与运行时配置 基于 dev 分支源码 · 2026-07-22 一、运行时环境：OpenCode 的配置入口 前十四讲覆盖了 OpenCode 从 CLI 到 Database 的完整架构。这一讲进入 Env 与运行时标志 ——OpenCode 通过环境变量、Flag 系统、InstanceState 和运行时服务构建的动态配置体系。这套机制横跨 4 个核心模块 ，控制从日志级别到实验功能开关的每一个运行时行为。 📦 本讲核心文件 packages/core/src/flag/flag.ts （78 行）— 运行时标志系统 packages/opencode/src/env/index.ts （41 行）— Env Effect 服务 packages/core/src/global.ts （87 行）— 全局路径与 XDG 目录 packages/opencode/src/effect/instance-state.ts （69 行）— 实例级状态 packages/core/src/observability/logging.ts （71 行）— 日志配置 packages/core/src/observability/otlp.ts （79 行）— 可观测性追踪 packages/opencode/src/effect/runtime-flags.ts （77 行）— Effect 化运行时标志 packages/opencode/src/effect/run-service.ts （47 行）— 运行时工厂 二、Flag 系统：运行时标志的统一入口 flag.ts （78 行）是 OpenCode 的 运行时标志中枢 。它将所有 OPENCODE_ 前缀的环境变量集中管理，提供统一的访问接口。 1. truthy() 与 enabledByExperimental() 解析器 📄 flag/flag.ts (第 1-13 行) export function truthy(key: string) { const value = process.env[key]?.toLowerCase() return value === "true" || value === "1" } function enabledByExperimental(key: string) { return process.env[key] === undefined ? truthy("OPENCODE_EXPERIMENTAL") : truthy(key) } 设计要点： truthy() 将环境变量值标准化为布尔值（"true" 或 "1" 为真）。更巧妙的是 enabledByExperimental() ——它实现了 实验功能总开关 模式：如果某个具体标志未设置，则回退到 OPENCODE_EXPERIMENTAL 全局开关。这意味着用户可以通过一个环境变量批量开启所有实验功能。 2. Flag 对象：30+ 运行时标志 📄 flag/flag.ts (第 15-78 行) export const Flag = { // OpenTelemetry OTEL_EXPORTER_OTLP_ENDPOINT: ..., OTEL_EXPORTER_OTLP_HEADERS: ..., // 运行时行为 OPENCODE_AUTO_HEAP_SNAPSHOT: truthy("..."), OPENCODE_GIT_BASH_PATH: process.env["..."], OPENCODE_CONFIG: process.env["..."], OPENCODE_CONFIG_CONTENT: process.env["..."], OPENCODE_DISABLE_AUTOUPDATE: truthy("..."), OPENCODE_DISABLE_FFF: ..., // Windows 默认开启 // 实验功能 OPENCODE_EXPERIMENTAL_FILEWATCHER: Config.boolean(...), OPENCODE_EXP…
阅读全文：OpenCode 源码解析 第 15 讲