用途:为 Native SDK 中的 Zig 0.16 代码提供按编译错误检索的迁移参考。Native SDK 要求 Zig 0.16.0(build.zig.zon 的 minimum_zig_version),CLI 会固定同一版本,并在 PATH 上的 zig 不匹配时把校验和验证过的下载放到 ~/.native/toolchains/。训练数据和旧指南多为 0.15 写法,而 0.16 把文件、stdout、时钟、休眠、进程创建、socket 等外部世界操作移到显式 std.Io 之后,容器也改为按调用传分配器。每条以旧写法产生的确切编译错误为标题,可用错误文本检索。
主要能力与规则:涉及外部世界的操作首先(或在接收者之后)传 std.Io,可来自 main(init: std.process.Init) 的 init.io、测试中的 std.testing.io,或 std.Io.Threaded;容器改为 unmanaged,用 .empty 初始化并把分配器传给每个可变调用。分配器来自 main(init: std.process.Init) 的 init.gpa/init.arena;文件 IO 移到 std.Io.Dir;writer 为 std.Io.Writer,stdout 为 std.Io.File.stdout();枚举与 tagged union 用 {t} 打印、自定义 format 方法用 {f};时钟与休眠在 Io 上;进程创建为 std.process.spawn(io, ...);环境与参数来自 Init;trimRight/trimLeft 改名 trimEnd/trimStart;socket 在 std.Io.net;build.zig 产物接收 module。
限制与注意:UiApp 的 update 看不到 Io,需走类型化 effects 通道;整文件 IO 上限 1 MiB,流式读 256-KiB 块,流式写 close 时原子完成;外部原始路径需文件系统权限;凭据需能力与权限,成功 get 的字节应立即消费且不得留在 Model。由于 Zig 惰性分析,完成前应同时运行 zig build 和 zig build test。多个 std.fmt、std.mem、std.debug.print、page_allocator 等保持不变,勿迁移。