← 返回 学习

快速入门

• 选择带版本号的版本还是开发版本？
• 安装 Zig
  • 直接下载
    • 在 Windows 上设置 PATH
    • 在 Linux, MacOS, BSD 上设置 PATH 将 zig 二进制镜像的位置添加到 PATH 环境变量中。
  • 包管理
    • Windows
    • macOS
    • Linux
  • 从源码构建
• 推荐工具
  • 语法高亮和语言服务器（LSP）
• 运行 Hello World
• 下一步

选择带版本号的版本还是开发版本？

总体上，带版本号版本对于有依赖并受益于稳定性的项目更实用，同时开发版本向希望更多参与 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

最新的 开发版本:

scoop bucket add versions
scoop install versions/zig-dev

macOS

Homebrew
最新带标签版本：

brew install zig

MacPorts

sudo port install zig

Linux

Zig 也存在于许多 Linux 的包管理器中。

从源码构建

参见 README.md.

推荐工具

语法高亮和语言服务器（LSP）

所有主流文本编辑器都有 Zig 的语法高亮支持。有一些内置此功能，有一些需要安装插件。

如果你对 Zig 和你的编辑器的深度整合感兴趣，可以查看 zigtools/zls。

如果你对其他的工具感兴趣，可以查看工具章节。

运行 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 开发，考虑捐助 Zig 软件基金会 .