用途:该技能用于编写和调试 Zig 项目的构建脚本,基于 std.Build,面向 Zig 0.16.0。适用场景包括编写 build.zig、配置 build.zig.zon 包元数据与依赖、模块创建与导入、交叉编译、C/C++ 集成、自定义构建步骤与测试聚合。
主要能力:可创建可执行文件、静态/动态库与对象文件;通过 b.createModule 创建模块并用 root_module.addImport 注入依赖;在 build.zig.zon 中声明名称、版本、minimum_zig_version、dependencies 与 paths;支持 b.dependency 与 b.lazyDependency 懒依赖;支持自定义目标(如 wasm32-freestanding)、多目标构建与主机工具;支持 addCSourceFiles、addIncludePath、addCMacro、linkSystemLibrary、link_libc/link_libcpp 及配置头文件;支持 addWriteFiles、addSystemCommand、代码生成、fmt 与 clean 步骤。
使用方式:先以 zig version 确认 0.16.0,明确目标类型,配置 build.zig.zon,编写 build.zig,再运行 zig build、zig build run、zig build test 验证。常用命令包括 zig build --list-steps、zig build -Dtarget=x86_64-linux -Doptimize=ReleaseFast、zig build --release=fast、zig build --watch、zig build --fetch、zig build -p /usr/local、zig fetch <url>。
限制与注意:不负责项目结构初始化与合规检查,也不覆盖 Zig 语言基础。root_source_file 已移除,须用 root_module = b.createModule(...);模块导入用 root_module.addImport;编译级方法需改用 root_module.* 版本;build.zig.zon 的 .name 仅允许 [a-z0-9-];paths 需显式声明;b.addTest 不再接受 root_source_file;懒依赖返回 ?*Dependency。调试可用 zig build --verbose、--verbose-link、--verbose-cc。该技能不收集、存储或传输用户数据。