跳转到内容

快速入门

入门通用入门资料官方原文

选择正式发布版还是开发版?

一般来说,正式发布版更适合有依赖、重视稳定性的项目;开发版则面向希望参与 Zig 项目开发的人。

Zig 的安装包是自包含的归档文件,可以放在系统中的任意位置。多个版本的 Zig 可以同时存在,互不干扰。

安装 Zig

直接下载

这是获取 Zig 最直接的方式:从下载页面获取适用于你所用平台的 Zig 压缩包,解压到某个目录,再将该目录加入 PATH,就能在任意位置调用 zig。

在 Windows 上设置 PATH

要在 Windows 上设置 PATH,请在 PowerShell 中运行下列代码片段中的一段。根据需要,选择在系统范围内应用此更改(需要以管理员权限运行 PowerShell),还是只对当前用户生效,并且务必修改代码片段,使其指向你的 Zig 所在的位置。C: 前面的 ; 不是笔误。

系统范围(管理员 PowerShell):

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

用户范围(PowerShell):

Terminal window
[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。

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

完成后,用 source 重新加载启动文件,或者重新启动 shell。

包管理器

Windows

WinGet
Zig 已在 WinGet 上提供。

Terminal window
winget install -e --id zig.zig

Chocolatey
Zig 已在 Chocolatey 上提供。

Terminal window
choco install zig

Scoop
Zig 已在 Scoop 上提供。

Terminal window
scoop install zig

最新开发版:

Terminal window
scoop bucket add versions
scoop install versions/zig-dev

macOS

Homebrew
最新正式发布版:

Terminal window
brew install zig

MacPorts

Terminal window
sudo port install zig

Linux

许多 Linux 包管理器中也提供 Zig。

从源码构建

参见 README.md。

推荐工具

语法高亮与 LSP

所有主流文本编辑器都支持 Zig 语法高亮,有的内置支持,有的需要安装插件。

如果希望 Zig 与编辑器更深入地集成,可以看看 zigtools/zls。

如果想了解还有哪些工具,请查看工具一节。

运行 Hello World

如果安装过程正确完成,现在应该可以在 shell 中调用 Zig 编译器了。
下面创建你的第一个 Zig 程序来测试一下!

进入你存放项目的目录,运行:

Terminal window
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 版本对应的文档(注意:nightly 构建应使用 master 文档),也可以读一读 zig.guide。

Zig 是一个年轻的项目,遗憾的是,我们暂时还没有能力为所有内容编写详尽的文档和学习资料。因此,遇到困难时可以考虑加入现有的某个 Zig 社区寻求帮助,也可以关注 Zig SHOWTIME 这类活动。

最后,如果你喜欢 Zig,并希望帮助加快它的开发,请考虑向 Zig 软件基金会捐款。

heart.