# 想在本机跑通 Zig 的最小例子，安装入口和文档对不上

**URL:** <https://www.shiqidu.com/t/topic/2041>\
**Category:** 开发调优\
**Tags:** 问与答, Linux, 编程, 开源软件\
**Created:** [2026 年11 月 12 日 05:47 UTC](https://www.shiqidu.com/t/topic/2041 "2026-11-12T05:47:03Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

作者： ![shiqidu\_editor](https://www.shiqidu.com/user_avatar/www.shiqidu.com/shiqidu_editor/32/528_2.png) [@shiqidu\_editor](https://www.shiqidu.com/u/shiqidu_editor)\
发布日期： [2026 年11 月 12 日 05:47 UTC](https://www.shiqidu.com/t/topic/2041/1 "2026-11-12T05:47:03Z")

</div>

有人按发行说明下了压缩包，打开的却是开发构建那一版参考。另一些人用系统包管理器装好，终端却提示找不到 `zig`，或生成的项目结构和眼前这一页不一样。语言本身还没写到业务里，已经卡在该装哪一份、该对哪份说明上，例子也就跑不起来。

[Zig 的 Getting Started](https://ziglang.org/learn/getting-started/) 先把两条线分开：带标签的发行版更适合依赖稳定的项目。开发构建面向想参与 Zig 本身开发的人。安装包是自包含的归档，可以放在系统的任意位置，多份版本也可以并存，不必先卸载旧的再装新的。最直接的做法是到该页指向的 Downloads 取对应平台的包，解压后把可执行文件所在目录加进 `PATH`，这样在任意位置都能调用 `zig`。Linux 和 macOS 上通常是在 `.profile` 或 `.zshrc` 这类启动脚本里写一行 `export PATH=$PATH:~/path/to/zig`，改完后要重新加载或开一个新终端。Windows 上则用 PowerShell 的 `SetEnvironmentVariable` 改用户或系统级路径，改系统级需要管理员权限，只改当前用户则不必。该页示例里路径前的分号不是笔误，需要保留。改完同样要新开一次会话才会生效。该页同时列出了若干包管理器入口，例如 Windows 上的 WinGet、Chocolatey、Scoop，macOS 上的 Homebrew 和 MacPorts，并提到不少 Linux 发行版的包管理器里也能找到它。从源码构建则指向仓库里的 README，只想跑通最小项目时不必一上来走这条路。

装好之后，文档里的第一段例子不是手写一份孤立的源文件，而是用官方脚手架。在项目目录里执行 `mkdir hello-world`、`cd hello-world` 再运行 `zig init`，它会生成 `build.zig`、`build.zig.zon`、`src/main.zig` 和 `src/root.zig`，并提示可用 `zig build --help` 查看选项。接着 `zig build run` 会编译并运行，成功时打印 `All your codebase are belong to us.`，以及一句让你执行 `zig build test` 的提示。能看到这几行，安装就算对上了。若命令找不到，多半是 `PATH` 还没生效。若能运行但生成的文件或输出和文档不一致，就要核对当前 `zig version` 和正在阅读的说明是不是同一条线。

文档对不上，常见原因正是版本没对齐。入门页在 Next steps 里写得很明确：要找和自己安装的 Zig 相对应的文档。夜间构建应使用 `master` 那一套。装的是带标签的发行版，却去读开发树上的说明，或反过来，命令、生成文件和示例输出都可能对不上。编辑器方面，该页只说主流编辑器都有语法高亮，有的内置、有的要装插件。更深的集成可以看 zigtools/zls，并不要求先配完整条工具链才能跑通上面那个例子。入门页还指向 Learn 栏目里的其他材料。Zig 仍是年轻项目，官方也承认目前还没有为所有主题写出足够详尽的教材。最小例子跑通之后若再卡住，应回到与当前版本匹配的那份说明，而不是混用另一条线上的内容。

Zig 解决的是「在本机把编译器装好、把官方最小项目跑起来」，不是拿来排语言路线，也不是和别的系统级语言做全面对比。若还在想要不要按某条语言路径学下去，站内有过一篇 [AI 时代要不要按语言路线学编程](https://www.shiqidu.com/t/topic/2003) 的讨论，和这次只想跑通例子不是同一件事。

你们本机的 `zig` 是解压归档装的，还是包管理器装的？跑 `zig build run` 时，输出能对上入门页上的那两行吗？