如何通过Zig构建系统及编译参数实现条件编译？

当然可以，Zig提供了两种核心方式来实现这类条件编译功能：

1. 通过Zig构建系统（build.zig）配置 #

方式一：直接添加预定义宏 #

在build.zig中，针对编译目标使用.defineMacro方法，对应CMake的add_definitions：

const std = @import("std");

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

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

    // 无值宏，对应C/C++的-DFOO
    exe.defineMacro("FOO", null);
    // 带值宏，对应C/C++的-DBAR=\"hello\"
    exe.defineMacro("BAR", "\"hello\"");

    b.installArtifact(exe);
}

方式二：使用配置选项模块 #

如果需要支持命令行开关或更灵活的配置，可通过addOptions创建配置模块：

const std = @import("std");

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

    // 创建可配置选项
    const options = b.addOptions();
    options.addOption(bool, "enable_foo", b.option(bool, "enable_foo", "开启FOO特性") orelse false);
    options.addOption([]const u8, "bar_value", b.option([]const u8, "bar_value", "BAR的取值") orelse "default");

    const exe = b.addExecutable(.{
        .name = "my_app",
        .root_source_file = .{ .path = "src/main.zig" },
        .target = target,
        .optimize = optimize,
    });
    // 将配置模块链接到编译目标
    exe.addOptions("build_options", options);

    b.installArtifact(exe);
}

2. 通过命令行参数临时定义 #

直接使用zig build命令时，可通过-D参数传递临时预定义，对应C/C++编译时的-D参数：

# 定义无值宏FOO
zig build -DFOO
# 定义带值宏BAR，取值为123
zig build -DBAR=123

Zig代码中的条件编译实现 #

对应直接宏定义的写法 #

针对用.defineMacro或命令行-D添加的宏，可通过@hasDecl判断是否定义，或直接访问宏值：

const std = @import("std");
const builtin = @import("builtin");

pub fn main() void {
    if (@hasDecl(builtin, "FOO")) {
        std.debug.print("FOO已启用\n", .{});
    }

    if (@hasDecl(builtin, "BAR")) {
        std.debug.print("BAR的值: {s}\n", .{builtin.BAR});
    }
}

对应配置选项模块的写法 #

如果用的是addOptions创建的配置模块，需导入后直接访问选项：

const std = @import("std");
const build_options = @import("build_options");

pub fn main() void {
    if (build_options.enable_foo) {
        std.debug.print("FOO特性已开启\n", .{});
    }

    std.debug.print("BAR的取值: {s}\n", .{build_options.bar_value});
}

内容的提问来源于stack exchange，提问作者KindFrog