Zig 0.17 构建系统重构：Maker 与 Configurer 双进程架构
内容提要
Zig 0.17 重构构建系统，将单体 Build Runner 拆分为 Maker 与 configurer 两个进程：前者负责任务调度，后者执行 build.zig 并序列化构建图。新增配置缓存与污染检测，引入 findProgramLazy、addPassthruArgs 等 API 以避免缓存失效；缓存改为二进制格式，并提供 zig cache-cat 查看工具。同时剥离编译器内嵌的网络与归档功能，推出官方 Build Server Protocol 供 IDE 使用。
延伸解读
双进程架构的职责分离
Zig 0.17 将构建系统拆分为 Maker 和 configurer 两个进程，前者负责任务调度与执行，后者专门执行 build.zig 并序列化构建图。这种分离使配置阶段与执行阶段解耦，配置结果可被缓存复用，而执行阶段可独立进行多线程调度。对于开发者而言，这意味着修改 build.zig 后只需重新运行 configurer，而源码变更则直接触发 Maker 的增量构建，提升了构建效率。
配置缓存与污染检测机制
新引入的配置缓存将构建图序列化为二进制格式，并通过污染检测确保缓存有效性。当 build.zig 中调用 findProgram 等扫描外部环境的 API 时，配置会被标记为污染，缓存文件在使用后即被删除。为避免污染，0.17 提供了 findProgramLazy 和 dependOnFileContents 等 API，将外部依赖的解析推迟到执行阶段或显式声明，从而保持配置的纯函数性，使缓存能够持续命中。
缓存格式变更与调试工具
缓存记录从 ASCII 文本改为二进制格式，提升了比对效率，但无法直接阅读。为此 Zig 0.17 新增了 zig cache-cat 命令，可将二进制 Manifest 反序列化为可读的 ZON 结构，展示文件大小、inode、mtime 和哈希等信息。当构建出现意外未命中时，开发者可用此工具快速定位是哪个文件的元数据变化导致缓存失效，便于排查构建问题。
编译器精简与 IDE 协议标准化
Zig 0.17 将网络、归档等非核心功能从编译器本体剥离，使二进制体积更小。同时移除了覆写 Build Runner 的能力，推出官方 Build Server Protocol，通过 zig build --listen=- 与 IDE 通信。这结束了以往依赖侵入式自定义 Build Runner 的脆弱做法，为 ZLS 等工具提供了稳定、标准的构建信息获取方式，降低了因编译器升级而失效的风险。
Q&A
Zig 0.17 构建系统为什么要从单体 Build Runner 拆分成 Maker 和 Configurer 两个进程？
在 Zig 0.16 及之前，执行 zig build 会将 build_runner.zig 和用户项目的 build.zig 动态编译成一个单一的临时二进制程序，这种单体设计存在每次改动 build.zig 均需重新编译等问题。0.17 彻底废除了 Build Runner 概念，将构建生命周期切分为职责正交的两个独立进程：Maker 负责任务调度，Configurer 负责执行 build.zig 并序列化构建图，从而提升构建系统的效率和可维护性。
Zig 0.17 中 Maker 和 Configurer 各自负责什么？它们是如何协作的？
Maker 是主控进程，负责加载二进制构建图配置、解析包依赖、多线程并发调度 Step，并管理会话模式（如 --watch/--listen）。Configurer 是短生命周期进程，由 Maker 按需派生，执行 build.zig 并构建内存图，然后序列化为紧凑二进制流通过管道传回 Maker。协作流程：Maker 先检查配置缓存是否命中且未污染，若命中则直接读取缓存，否则派生 Configurer 执行配置，Configurer 输出二进制配置流，Maker 加载后进入任务调度阶段。
Zig 0.17 如何避免 build.zig 中的外部环境查询导致配置缓存失效？
Zig 0.17 引入了 findProgramLazy 和显式依赖声明 API 来避免缓存污染。findProgramLazy 将 PATH 查找推迟到 Make 阶段，不在配置期解析外部工具路径，从而不污染配置缓存。对于需要根据外部文件或目录内容决定构建分支的情况，可以使用 b.dependOnFileContents、b.dependOnFileMetadata、b.dependOnDirectoryContents、b.dependOnDirectoryMetadata 显式声明依赖，Maker 会将这些文件或目录的哈希纳入配置缓存凭证，只要它们未改变，配置缓存依然有效。
Zig 0.17 中处理运行时命令行参数（如 zig build run -- --port 8080）有什么新方式？
在 0.17 中，不再允许在配置期直接读取 b.args，因为这样会导致每次更换运行参数都生成不同的 Run 节点，使配置缓存失效。新的标准做法是使用 addPassthruArgs()，在配置阶段 DAG 中仅记录一个 .passthru 占位标识符，无论命令行如何更换透传参数，构建图本身的哈希签名保持不变，配置缓存继续命中。参数的实际拼接推迟到了 Maker 调度该 Step 的 Make 执行阶段。
Zig 0.17 的缓存格式有什么变化？如何查看缓存内容？
Zig 0.17 将缓存记录文件从普通的 ASCII 文本（.zig-cache/h/...txt）改为二进制格式，以提高缓存比对效率。由于二进制格式不可直读，0.17 新增了官方反序列化查看工具 zig cache-cat，它可以将二进制 Manifest 直接格式化为可读的 ZON 数据结构，帮助开发者检查是哪个文件的 mtime、size 或哈希导致了缓存失效。
Zig 0.17 为 IDE 提供了什么新的构建集成方式？
Zig 0.17 彻底移除了覆写 Build Runner 的能力，并正式推出了官方的 Build Server Protocol。IDE 可以通过 zig build --listen=- 与构建系统进行标准化协议通信，获取项目的真实构建选项、包含路径与模块依赖等信息。这意味着 IDE 与构建系统的交互从以往的黑盒猜测与 Hack 转向了官方标准化的协议通信。
