Zig Academy · 课时

包装并重新抛出错误

Q: 「包装并重新抛出错误」这节课中我会学到什么？

让错误向上传递时附加上下文。 你通过在浏览器中直接运行的动手代码来练习 Zig Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

让错误向上传递时附加上下文。

第 4 / 4 课13 个步骤

包装并重新抛出错误 是 CoddyKit 上的免费 Zig Academy 课时。这是第 4 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Zig Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Zig Academy 课程共包含 4 节课。

错误会向上传递

当函数无法自行处理失败时，它会将错误传递给调用方。在此过程中，您可以调整错误或将其重新抛出。

使用 try 重新抛出

最简单的重新抛出方式是 try。它会将原始错误原封不动地转发给调用方，因此同一个值会继续向上传递。

const data = try readFile(path);

捕获后返回

要转换错误，请使用 catch 捕获它，然后返回另一个错误。这样就能将底层错误替换为符合您自己接口的错误。

const f = open(path) catch return error.ConfigMissing;

使用 switch 映射错误

将 catch 与 switch 结合，可以把每个底层错误映射为更清晰的错误，同时让其余错误原样传递。

parse(s) catch |e| switch (e) {
    error.Empty => return error.NoInput,
    else => return e,
};

Zig 不会通过值携带堆栈跟踪

Zig 中的错误只是一个标签，而不是携带上下文的对象。要添加详细信息，您需要重新抛出一个由您定义的、更具描述性的错误。

单独附加上下文

由于错误标签不携带消息，请在失败发生的位置记录详细信息，然后将更高层的错误返回给调用方。

open(path) catch |e| {
    std.log.err("open {s}: {}", .{ path, e });
    return error.LoadFailed;
};

扩大错误集合

如果您返回一个新错误，函数的错误集合必须包含它。推断出的 !T 集合会扩展，以涵盖您返回的所有错误。

fn load() !Config {
    return open(".cfg") catch error.LoadFailed;
}

保留还是替换

在每一层分别决定：使用 try 转发完全相同的错误，还是将它替换为对调用方更有意义的错误。两种方式都正确。

保持边界清晰

在模块边界处，将内部错误映射到一个较小的公共集合。这样调用方依赖的是稳定名称，而不是您的内部实现。

与 errdefer 配合使用

重新抛出错误时，作用域中的任何 errdefer 仍会先执行。因此，您可以在同一路径中回滚资源并转换错误。

有意义的失败

包装错误可以将原始原因转换为符合您领域的消息。调用方看到的是清晰的错误，而不是内部细节。

快速检查

您想将底层错误 error.NotFound 替换为自己的 error.ConfigMissing 并返回给调用方。哪种方式可行？

在交互式课程中回答

回顾

您使用 try 重新抛出错误，通过 catch 和 switch 映射错误，记录上下文，并扩大错误集合，使失败信息更有意义。✅

免费开始

用 AI 导师学习 Zig — 免费

在浏览器中编写并运行真实代码，获得全天候 AI 导师的即时帮助，并在网页或应用中继续学习。

课程: 30
课程: 120

免费开始学习查看完整课程

常见问题解答

「包装并重新抛出错误」课时是免费的吗？

是的 — 「包装并重新抛出错误」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Zig Academy 课程的其余内容，请升级到 CoddyKit PRO。 Zig Academy 课程共包含 4 节课。

「包装并重新抛出错误」这节课中我会学到什么？

让错误向上传递时附加上下文。你通过在浏览器中直接运行的动手代码来练习 Zig Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Zig Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Zig Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 4 节课，共 4 节。

「包装并重新抛出错误」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Zig Academy 课中编写并运行代码吗？

能。每节 Zig Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Zig Academy