Zig 0.13.0模块导入报错求助：无法找到'shared'模块

问题根源 #

1. 相对路径导入报错：直接用zig test测试单个文件时，该文件所在目录会被当作模块根目录，Zig禁止跨模块根导入外部文件，所以../shared/util.zig会触发路径越界错误。
2. 模块找不到：zig test单文件模式不会读取build.zig中的模块配置，你定义的shared模块对独立测试进程不可见，因此@import("shared")会报错。

解决方案一：通过build.zig配置测试目标 #

这是最规范的方式，利用Zig构建系统管理模块依赖和测试：

1. 完善模块依赖关联
   在build.zig中，给fooModule添加对sharedModule的依赖，确保foo模块内的所有文件都能访问shared模块：

   const sharedModule = b.addModule("shared", .{
       .root_source_file = b.path("src/shared/shared.zig"),
   });
   
   const fooModule = b.addModule("foo", .{
       .root_source_file = b.path("src/foo/foo.zig"),
       // 让foo模块能直接引用shared模块
       .imports = &.{
           .{ .name = "shared", .module = sharedModule },
       },
   });
   

2. 添加bar.zig的专属测试目标
   在build.zig末尾添加以下代码，创建独立的测试任务：

   // 配置bar.zig的测试目标
   const bar_tests = b.addTest(.{
       .root_source_file = b.path("src/foo/bar.zig"),
       .optimize = b.standardOptimizeOption(.{}),
   });
   // 给测试目标导入shared模块
   bar_tests.root_module.addImport("shared", sharedModule);
   // 安装测试可执行文件
   b.installArtifact(bar_tests);
   // 创建运行测试的步骤
   const run_bar_tests = b.addRunArtifact(bar_tests);
   const test_bar_step = b.step("test-bar", "Run tests in bar.zig");
   test_bar_step.dependOn(&run_bar_tests.step);
   

3. 运行测试
   执行以下命令即可运行bar.zig的测试：

   zig build test-bar
   

解决方案二：命令行临时指定模块（快速调试） #

如果不想修改build.zig，可以通过--import参数在测试时临时关联模块：

zig test src/foo/bar.zig -O Debug --import shared:src/shared/shared.zig

该命令会将shared模块映射到src/shared/shared.zig，此时@import("shared").util就能正常工作。

模块内部导入说明 #

你的shared.zig写法是正确的：

pub const util = @import("util.zig");

这种方式可以将util.zig的内容通过shared模块导出，其他模块只需引用shared模块就能访问util，无需关心util的具体路径。

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