如何在Zig中通过命令行修改std.log日志级别及测试日志配置

直接使用zig test快速配置 #

无需修改构建脚本，直接通过命令行传递编译定义即可设置std.testing.log_level：

zig test src/main.zig -Dstd.testing.log_level=debug

支持的级别值为：debug、info、warn、err，测试中std.log会输出对应级别及更高级别的日志内容。

通过zig build test自定义构建配置 #

如果需要通过统一构建脚本管理测试参数，可修改build.zig添加日志级别选项：

1. 修改build.zig添加配置 #

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

    // 添加命令行选项，默认日志级别为info
    const log_level = b.option(std.log.Level, "log-level", "Set log level for tests (debug, info, warn, err)") orelse .info;

    // 定义测试步骤
    const test_step = b.step("test", "Run all tests");

    // 创建测试目标
    const exe_tests = b.addTest(.{
        .root_source_file = .{ .path = "src/main.zig" },
        .target = target,
        .optimize = optimize,
    });

    // 将日志级别作为编译时枚举值注入std.testing.log_level
    exe_tests.defineValue("std.testing.log_level", .{ .Enum = .{
        .tag = log_level,
        .type = std.log.Level,
    } });

    // 关联测试运行步骤
    const run_tests = b.addRunArtifact(exe_tests);
    test_step.dependOn(&run_tests.step);
}

2. 运行带日志级别的测试 #

通过-Dlog-level参数指定级别：

# 设置为debug级别
zig build test -Dlog-level=debug

# 设置为warn级别
zig build test -Dlog-level=warn

测试代码中使用日志 #

在测试函数中直接调用std.log相关方法即可，日志输出会自动遵循设置的级别：

const std = @import("std");
const testing = std.testing;

test "log level demo" {
    std.log.debug("仅debug级别可见", .{});
    std.log.info("info及以上级别可见", .{});
    std.log.warn("warn及以上级别可见", .{});
    std.log.err("所有级别都可见", .{});

    try testing.expect(true);
}

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