如何在 macOS、Linux 和 Windows 上安装 Zero

一行命令安装

获取 Zero 最快的方式是官方安装脚本：

curl -fsSL https://zerolang.ai/install.sh | bash

这个脚本会为你的平台下载预编译好的编译器，并放到 ~/.zero/ 下，可执行文件本身位于 ~/.zero/bin/zero。它不会写入你的主目录以外的任何地方：不需要 sudo，也不会改动系统设置。

如果你想先检查脚本再运行，可以先把它下载下来，而不是直接用管道交给 shell：

curl -fsSL https://zerolang.ai/install.sh -o zero-install.sh
less zero-install.sh
bash zero-install.sh

对任何 curl | bash 式的安装来说，这都是好习惯，对实验性项目更是如此。

把 Zero 加入 PATH

安装脚本会提示你下一步该做什么，但这里还是值得再说一遍。把 ~/.zero/bin 加入你的 PATH，这样在任何目录下都能运行 zero：

export PATH="$HOME/.zero/bin:$PATH"

要让它永久生效，把同一行追加到你使用的 shell 启动文件中：

• zsh（新版 macOS 的默认 shell）：~/.zshrc
• bash：~/.bashrc（Linux）或 ~/.bash_profile（旧版 macOS）
• fish：在 ~/.config/fish/config.fish 中加入 fish_add_path $HOME/.zero/bin

编辑完文件后，打开一个新的终端窗口，或者运行 source ~/.zshrc（或对应的命令），让新的 PATH 在当前会话中生效。

验证安装

在新的终端里查看 Zero 的版本：

zero --version

你应该会看到一个版本号。如果出现 command not found，说明可执行文件还不在 PATH 里：再检查一遍上面的 export 那一行，并确认 ~/.zero/bin/zero 确实存在：

ls -l ~/.zero/bin/zero

如果文件不存在，重新运行安装脚本，并留意输出中有没有错误。

各平台说明

macOS

在较新的 macOS 上（Apple Silicon 或 Intel），安装脚本配合默认的 zsh 可以直接使用。第一次运行 zero 时，你可能需要在 Gatekeeper 中放行它：系统设置 → 隐私与安全性 → “仍要允许”。点一次之后，它就能正常运行了。

Linux

这个脚本开箱即支持基于 glibc 的发行版，已在 Ubuntu、Debian 和 Arch 系发行版上测试过。在精简的容器里，你可能需要 curl 和可用的 C 运行时；运行脚本前先用包管理器安装它们。

Windows（通过 WSL2）

目前还没有原生的 Windows 安装程序。支持的方式是 WSL2：

1. 以管理员身份打开 PowerShell，运行 wsl --install 安装 WSL2。
2. 从 Microsoft Store 选一个 Linux 发行版（Ubuntu 就可以）。
3. 打开新的 Linux shell，在里面运行标准的 curl 安装命令。

在 WSL2 下构建的 Zero 程序是 Linux 可执行文件。你可以在 WSL2 内运行它们，也可以通过 WSL 互操作从 Windows 调用，但不能把它们作为原生 .exe 文件发布。

更新 Zero

最简单的升级方式是重新运行同一个安装脚本，它会覆盖 ~/.zero/bin 中已有的可执行文件。由于 Zero 还处于 1.0 之前，新版本很可能带来破坏性变更：如果你和别人共享代码库，最好在本地固定一个可用的版本。

卸载

分两步：

rm -rf ~/.zero

然后从 shell 配置文件中删除 export PATH="$HOME/.zero/bin:$PATH" 这一行。安装过程不会写入其他任何地方，所以这样就能彻底移除 Zero。

关于信任

Zero 是来自 Vercel 研究项目的 1.0 之前的软件。团队明确建议在隔离的环境中运行它，比如沙盒开发机、容器或虚拟机；如果你要处理敏感数据，就不要装在主力工作电脑上。安装脚本很短，运行之前值得读一遍，尤其是在这个项目还在不断变化的时候。

下一步：Hello, World

工具链装好、zero --version 能正常运行后，你就可以编译第一个程序了。Hello, World 会带你编写、运行并逐行剖析一个最小的 .0 文件。