0Pricing
Zig Academy · 课时

build.zig.zon 与包管理器

在清单中声明依赖

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

软件包的清单

build.zig 旁边有 build.zig.zon，它是用于命名软件包并列出其依赖项的清单。📜

ZON 是 Zig 对象表示法

该文件使用 ZON 编写，看起来就像 Zig 的匿名结构体字面量。带点号的字段名称会映射到普通的 Zig 值。

.{
    .name = .myapp,
    .version = "0.1.0",
}

名称和版本

有两个必需字段十分重要：name 用于标识软件包，而 version 遵循语义化版本规范，例如 1.2.0。

.name = .myapp,
.version = "0.1.0",

列出依赖项

dependencies 字段是一个由多个条目组成的结构体，每个条目对应一个您希望引入构建的外部软件包。

.dependencies = .{
    .mylib = .{},
},

URL 指向源代码

每个 dependency 都会提供一个指向压缩包的 url，通常是代码托管平台上的带标签归档文件。Zig 会为您下载并解压它。

.url = "https://example.com/mylib-1.0.0.tar.gz",

hash 锁定内容

hash 字段会固定下载内容的确切字节。如果内容发生任何变化，哈希值就会不匹配，构建也会拒绝使用它。

.hash = "122012ab...",

让 zig fetch 填写它

您很少需要手动输入哈希值。使用 url 运行 zig fetch，它会下载内容、计算哈希值，并为您写入条目。

zig fetch --save https://example.com/mylib-1.0.0.tar.gz

全局缓存

下载的软件包会存放在您计算机上的共享缓存中。多个项目可以复用同一份副本，因此同一个依赖项不会被存储两次。

paths 声明要发布的内容

paths 字段列出软件包作为依赖项时所包含的文件。使用 .{""} 可以发布文件夹中的所有内容。

.paths = .{ "build.zig", "src" },

提交清单

由于其中包含确切的哈希值，build.zig.zon 可以让构建具有可复现性。请提交它，以便每位团队成员获取完全相同的代码。

build.zig 会读取它

清单与 build.zig 配合使用，后者会将每个声明的依赖项转换为可用模块。zon 文件负责描述，构建脚本负责连接。

const dep = b.dependency("mylib", .{});

快速检查

请回想一下，什么机制可以保证依赖项下载未被篡改。

回顾

您认识了 build.zig.zon：一个包含 name、version 和 dependencies 的 ZON 清单，其中每个 dep 都带有 url 和 hash，并且可以由 zig fetch 自动填写。🎯

常见问题解答

「build.zig.zon 与包管理器」课时是免费的吗？

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

「build.zig.zon 与包管理器」这节课中我会学到什么？

在清单中声明依赖 你通过在浏览器中直接运行的动手代码来练习 Zig Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Zig Academy 需要有经验吗？

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

「build.zig.zon 与包管理器」课时需要多长时间？

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

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

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

此课程中的所有课时

  1. 使用 @import 导入文件
  2. 构建多文件项目的结构
  3. build.zig.zon 与包管理器
  4. 添加第三方模块
← 返回 Zig Academy