← 返回学习

入门

标签发布版还是每夜构建版？
安装 Zig
- 直接下载
  - 在 Windows 上设置 PATH
  - 在 Linux、macOS、BSD 上设置 PATH
- 包管理器
  - Windows
  - macOS
  - Linux
- 从源码构建
推荐工具
- 语法高亮和 LSP
运行 Hello World
后续步骤

标签发布版还是每夜构建版？

Zig 尚未达到 v1.0 版本，当前的发布周期与 LLVM 的新版本发布相关联，大约每 6 个月发布一次。实际上，鉴于当前开发速度，Zig 的发布间隔往往较长，最终会变得过时。

使用带标签的版本评估 Zig 是可以的，但如果您决定喜欢 Zig 并想深入研究，我们鼓励您升级到每夜构建版，主要原因是这样您将更容易获得帮助：出于上述原因，大多数社区和像 zig.guide 这样的网站都追踪主分支。

好消息是，在不同 Zig 版本之间切换，甚至在系统上同时存在多个版本都非常容易：Zig 发布版是自包含的归档文件，可以放在系统的任何位置。

安装 Zig

直接下载

这是获取 Zig 最直接的方式：从下载页面获取适用于您平台的 Zig 包，将其解压到一个目录中，然后将其添加到您的 PATH 中，以便您可以在任何位置调用 zig。

在 Windows 上设置 PATH

要在 Windows 上设置 PATH，请在 Powershell 实例中运行以下代码片段中的一个。选择是要在系统范围级别应用此更改（需要以管理员权限运行 Powershell）还是仅适用于您的用户，并且确保修改代码片段以指向您的 Zig 副本所在的路径。C: 前的 ; 并非笔误。

系统范围 (管理员 Powershell)

[Environment]::SetEnvironmentVariable(
   "Path",
   [Environment]::GetEnvironmentVariable("Path", "Machine") + ";C:\your-path\zig-windows-x86_64-your-version",
   "Machine"
)

用户级别 (Powershell)

[Environment]::SetEnvironmentVariable(
   "Path",
   [Environment]::GetEnvironmentVariable("Path", "User") + ";C:\your-path\zig-windows-x86_64-your-version",
   "User"
)

完成后，重启您的 Powershell 实例。

在 Linux、macOS、BSD 上设置 PATH

将您的 zig 二进制文件位置添加到 PATH 环境变量中。

这通常通过在您的 shell 启动脚本（例如 .profile、.zshrc 等）中添加一行 export 命令来完成。

export PATH=$PATH:~/path/to/zig

完成后，要么 source 您的启动文件，要么重启您的 shell。

包管理器

Windows

WinGet
Zig 在 WinGet 上可用。

winget install -e --id zig.zig

Chocolatey
Zig 在 Chocolatey 上可用。

choco install zig

Scoop
Zig 在 Scoop 上可用。

scoop install zig

macOS

Homebrew
最新标签发布版

brew install zig

MacPorts

sudo port install zig

Linux

Zig 也存在于许多 Linux 包管理器中。这里您可以找到一个更新的列表，但请记住，某些包可能捆绑了过时的 Zig 版本。

从源码构建

这里您可以找到更多关于如何在 Linux、macOS 和 Windows 上从源码构建 Zig 的信息。

运行 Hello World

如果您正确完成了安装过程，现在应该能够从 shell 调用 Zig 编译器了。
让我们通过创建您的第一个 Zig 程序来测试一下！

导航到您的项目目录并运行

mkdir hello-world
cd hello-world
zig init

这应该会输出

info: created build.zig
info: created build.zig.zon
info: created src/main.zig
info: created src/root.zig
info: see `zig build --help` for a menu of options

运行 zig build run 应该会编译并运行可执行文件，最终得到

All your codebase are belong to us.
Run `zig build test` to run the tests.

恭喜，您的 Zig 已成功安装并运行！

后续步骤

查看学习部分中的其他资源，务必找到您所用 Zig 版本的文档（注意：每夜构建版应使用 master 分支的文档），并考虑阅读 zig.guide。

Zig 是一个年轻的项目，不幸的是，我们目前还没有能力为所有内容提供大量的文档和学习资料，因此您应该考虑加入现有的 Zig 社区之一，以便在遇到问题时获得帮助，并关注像 Zig SHOWTIME 这样的倡议。

最后，如果您喜欢 Zig 并希望帮助加速其发展，请考虑向 Zig 软件基金会捐款。

入门