zig-build-system

Files (1)

• SKILL.md

SKILL.md (first lines)

# Zig 构建系统

> 基于 std.Build 的构建脚本编写指南（Zig 0.16.0）。

## Capability Boundaries

### ✅ 强项
1. 编写 `build.zig` 构建脚本（可执行文件、库、对象文件）
2. 配置 `build.zig.zon` 包元数据与依赖管理
3. 模块创建、导入、依赖注入
4. 交叉编译与自定义目标配置
5. C/C++ 源代码集成与系统库链接
6. 构建选项、自定义构建步骤、代码生成
7. 测试配置与聚合

### ⚠️ 前置要求
1. 确认目标 Zig 版本（`zig version`）
2. 项目根目录包含 `build.zig`

### ❌ 不适用范围
1. 项目结构初始化 → 使用 `zig-project-structure` 技能
2. 项目合规检查 → 使用 `zig-project-structure` 技能
3. Zig 语言基础 → 使用 `zig-0.16` 技能

## 何时使用

- "帮我写一个 build.zig"
- "如何配置交叉编译到 wasm？"
- "如何在 build.zig 中添加 C 源文件？"
- "我想把项目拆成多模块"
- "添加一个第三方依赖"

## Data Privacy

本技能不收集、存储或传输任何用户数据。

## Workflow

步骤 1. **确认版本** — `zig version` 确认 0.16.0
步骤 2. **明确目标** — 可执行文件/库/多模块/测试？
步骤 3. **配置 build.zig.zon** — 名称、版本、依赖
步骤 4. **编写 build.zig** — 创建模块、链接、安装
步骤 5. **配置运行/测试步骤** — `zig build run` / `zig build test`
步骤 6. **验证** — `zig build` 确认编译通过

## 核心模式

### 最小可执行文件

```zig
const std = @import("std");

pub fn build(b: *std.Build) void {
    const target = b.standardTargetOptions(.{});
    const optimize = b.standardOptimizeOption(.{});

    const exe = b.addExecutable(.{
        .name = "myapp",
        .root_module = b.createModule(.{
            .root_source_file = b.path("src/main.zig"),
            .target = target,
            .optimize = optimize,
        }),
    });
    b.installArtifact(exe);

    const run_cmd = b.addRunArtifact(exe);
    run_cmd.step.dependOn(b.getInstallStep());
    if (b.args) |args| run_cmd.addArgs(args);
    const run_step = b.step("run", "运行应用");
    run_step.dependOn(&run_cmd.step);
}
```

### 多模块库

```zig
pub fn build(b: *std.Build) void {
    const target = b.standardTargetOptions(.{});
    const optimize = b.standardOptimizeOption(.{});

    const core_mod = b.createModule(.{
        .root_source_file = b.path("core/src/root.zig"),
        .target = target,
        .optimize = optimize,
    });
    const harness_mod = b.createModule(.{
        .root_source_file = b.path("harness/src/root.zig"),
        .target = target,
        .optimize = optimize,
    });
    harness_mod.addImport("core", core_mod);

    const core_lib = b.addLibrary(.{ .linkage = .static, .name = "core", .root_module = core_mod });
    core_lib.linkLibC();
    b.installArtifact(core_lib);

    // 测试聚合
    const test_step = b.step("test", "运行所有测试");
    for ([_]*std.Build.Module{ core_mod, harness_mod }) |mod| {
        const tests = b.addTest(.{ .root_module = mod });
        tests.linkLibC();
        test_step.dependOn(&b.addRunArtifact(tests).step);
    }
}
```

### 静态/动态库

```zig
// 静态库（默认）
const lib = b.addLibrary(.{
    .name = "mylib",
    .linkage = .static,
    .root_module = b.createModule(.{ .root_source_file = b.path("src/root.zig"), .target = target, .optimize = optimize }),
});

// 动态库
const dylib = b.addLibrary(.{

From Yabuku-xD/omfx, MIT.

More from Yabuku-xD/omfx