写入输出与退出代码
报告结果并传递状态
写入输出与退出代码 是 CoddyKit 上的免费 Zig Academy 课时。 这是第 3 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Zig Academy 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 Zig Academy 课程共包含 4 节课。
工具也会反馈信息
读取输入只是工作的一半。一个完整的 CLI 还会写入输出,并向运行它的对象报告成功或失败。📤
两个输出流
程序有两个通道:stdout 用于正常结果,stderr 用于消息和错误。将二者分开,可以让用户顺利地通过管道传递结果。
获取 stdout 的 writer
使用 std.io.getStdOut 获取 stdout,然后向它请求一个 writer。这个 writer 是将正常输出发送到终端的句柄。
const out = std.io.getStdOut().writer();使用 print 输出
writer 的 print 方法会在一次调用中完成格式化和写入,使用您已经熟悉的格式字符串和参数元组。
try out.print("Result: {d}\n", .{total});写入可能失败
输出会写入一个真实的数据流,而数据流可能已经关闭,因此写入操作会返回错误。这就是为什么每个 print 前面都要放置 try。
将错误发送到 stderr
请将警告和失败信息发送到 std.io.getStdErr,这样它们就不会污染通过管道传递的结果。用户可以在数据继续流动时阅读错误信息。
const err = std.io.getStdErr().writer();快速调试输出
对于粗略的日志记录,std.debug.print 会直接写入 stderr,无需使用 try。在开发过程中它很方便,但不适合真正的输出。
std.debug.print("loaded {d} items\n", .{count});退出代码约定
程序结束时会返回一个数字。零表示成功;任何非零值都表示发生了问题。
main 可以返回错误
将 main 的返回类型设为 !void。如果错误向外传播,Zig 会打印跟踪信息,并替您以非零代码退出。
pub fn main() !void {}选择您自己的代码
需要特定的状态码吗?请使用 u8 调用 std.process.exit。它会立即结束程序,并准确使用指定的退出代码。
std.process.exit(2);退出前刷新
如果使用了带缓冲的 writer,请在退出前调用 flush()。否则,缓冲的文本可能永远无法到达终端。
try bw.flush();快速检查
回想一下,退出代码会向启动您工具的 shell 传达什么信息。
回顾
您将结果写入 stdout,将错误写入 stderr,在每次写入时使用 try,并以清晰的退出代码结束。您的工具现在能够清楚地报告结果。🎯
常见问题解答
「写入输出与退出代码」课时是免费的吗?
是的 — 「写入输出与退出代码」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 Zig Academy 课程的其余内容,请升级到 CoddyKit PRO。 Zig Academy 课程共包含 4 节课。
「写入输出与退出代码」这节课中我会学到什么?
报告结果并传递状态 你通过在浏览器中直接运行的动手代码来练习 Zig Academy,全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Zig Academy 需要有经验吗?
无需任何先前经验。CoddyKit 上的 Zig Academy 课程适合初学者到高级学习者,你可以从这里开始或从头开始,按照自己的节奏学习。 这是第 3 节课,共 4 节。
「写入输出与退出代码」课时需要多长时间?
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动,所以你能稳步进步,并在网页和应用中从离开的地方继续。
我能在这节 Zig Academy 课中编写并运行代码吗?
能。每节 Zig Academy 课都包含内置代码编辑器,你可以在浏览器中直接编写并运行真实代码,并获得即时 AI 反馈 — 无需本地设置。
此课程中的所有课时
- 读取命令行参数
- 读取文件和 stdin
- 写入输出与退出代码
- 打包并发布二进制文件