跳转到内容

Zig 构建系统

语言参考Zig 0.17.0官方原文

Zig 构建系统提供跨平台、无额外依赖的方式,声明构建项目所需的逻辑。项目构建逻辑写在 build.zig 文件中,通过 Zig 构建系统接口声明并配置构建产物和其他任务。

构建系统可协助完成的任务包括:

  • 并行执行任务并缓存结果。
  • 依赖其他项目。
  • 提供供其他项目依赖的包。
  • 执行 Zig 编译器创建构建产物,包括编译 Zig、C 和 C++ 源码。
  • 接收用户配置选项,并用这些选项配置构建。
  • 提供可供 Zig 代码导入的文件,将构建配置暴露为编译时值。
  • 缓存构建产物,避免不必要的重复步骤。
  • 执行构建产物或系统已安装的工具。
  • 运行测试,并验证构建产物的执行输出符合预期值。
  • 对全部或部分代码库运行 zig fmt。
  • 自定义任务。

使用构建系统时,运行 zig build --help 查看命令行帮助,其中也包含 build.zig 脚本声明的项目专属选项。

目前,构建系统文档单独托管:构建系统文档