有人按发行说明下了压缩包，打开的却是开发构建那一版参考。另一些人用系统包管理器装好，终端却提示找不到 zig，或生成的项目结构和眼前这一页不一样。语言本身还没写到业务里，已经卡在该装哪一份、该对哪份说明上，例子也就跑不起来。
Zig 的 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 时代要不要按语言路线学编程 的讨论，和这次只想跑通例子不是同一件事。
你们本机的 zig 是解压归档装的，还是包管理器装的？跑 zig build run 时，输出能对上入门页上的那两行吗？