如何在Zig语言中组织大型项目，实现类CMake的子模块复用？

针对你想要的嵌套子模块结构，下面给出可复用的配置方案，同时纠正exe.addModule的用法误区：

1. 子模块库的独立build.zig配置 #

以projectB为例，它的build.zig需要同时支持独立构建和被主项目引用：

// projectB/build.zig
const std = @import("std");

pub fn build(b: *std.Build) void {
    // 标准目标和优化选项
    const target = b.standardTargetOptions(.{});
    const optimize = b.standardOptimizeOption(.{});

    // 定义供主项目引用的库模块
    const hello_module = b.addModule("hello", .{
        .source_file = .{ .path = "src/hello.zig" },
    });

    // 可选：构建独立静态库（如需单独编译子库）
    const lib = b.addStaticLibrary(.{
        .name = "projectB",
        .root_source_file = .{ .path = "src/hello.zig" },
        .target = target,
        .optimize = optimize,
    });
    b.installArtifact(lib);

    // 将模块暴露给主项目
    b.modules.put("hello", hello_module) catch unreachable;
}

对应的projectB/src/hello.zig示例代码：

// projectB/src/hello.zig
const std = @import("std");

pub fn sayHello() void {
    std.debug.print("Hello from projectB!\n", .{});
}

projectC的配置完全类似，仅需替换名称和实现即可。

2. 主项目projectA的build.zig配置 #

主项目需要导入子模块的构建脚本，获取其暴露的模块后关联到主可执行文件：

// projectA/build.zig
const std = @import("std");

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

    // 导入子模块的构建逻辑
    const projectB_dep = b.dependency("projectB", .{
        .target = target,
        .optimize = optimize,
    });
    const projectC_dep = b.dependency("projectC", .{
        .target = target,
        .optimize = optimize,
    });

    // 获取子模块暴露的模块
    const hello_module = projectB_dep.module("hello");
    const bye_module = projectC_dep.module("bye");

    // 创建主可执行文件
    const exe = b.addExecutable(.{
        .name = "projectA",
        .root_source_file = .{ .path = "src/main.zig" },
        .target = target,
        .optimize = optimize,
    });

    // 将子模块导入到主可执行的根模块（替代不存在的exe.addModule）
    exe.root_module.addImport("hello", hello_module);
    exe.root_module.addImport("bye", bye_module);

    // 安装可执行文件
    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 the app");
    run_step.dependOn(&run_cmd.step);
}

同时需要在主项目根目录创建zig.mod文件，声明子模块路径：

# projectA/zig.mod
[dependencies]
projectB = { path = "libs/projectB" }
projectC = { path = "libs/projectC" }

3. 主项目main.zig的模块引用 #

在主代码中直接导入子模块即可使用：

// projectA/src/main.zig
const hello = @import("hello");
const bye = @import("bye");

pub fn main() void {
    hello.sayHello();
    bye.sayBye();
}

关键说明 #

• 你提到的exe.addModule不存在是因为Zig构建系统API更新，当前正确的模块关联方式是exe.root_module.addImport。
• 子模块的build.zig通过b.dependency被主项目导入，既保留了子模块独立构建的能力，又能让主项目复用其模块逻辑。
• 若子模块无需独立构建，可简化其build.zig，仅保留模块定义和暴露逻辑即可。

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