目录

  1. 准备工作
  2. Windows 安装
  3. Linux 安装
  4. macOS 安装
  5. 验证安装
  6. 配置开发环境
  7. 常见问题与解决

准备工作

在开始安装之前，请确保：

  • 您有稳定的互联网连接以下载 Zig。
  • 您的操作系统是最新的（推荐但非必须）。
  • 您有管理员权限（某些步骤可能需要）。

Zig 官方推荐从 Zig 下载页面 获取最新版本。Zig 目前处于快速发展阶段，建议使用最新的稳定版（如 0.12.0）或 master 分支的夜间构建版。

Windows 安装

  1. 下载 Zig：
  • 访问 Zig 下载页面。
  • 选择适用于 Windows 的版本（如 zig-windows-x86_64-0.12.0.zip）。
  • 下载并解压到任意目录（如 C:\zig）。
  1. 设置环境变量：
  • 右键“此电脑” → “属性” → “高级系统设置” → “环境变量”。
  • 在“系统变量”或“用户变量”的 Path 中添加 Zig 的路径（如 C:\zig\zig-windows-x86_64-0.12.0）。
  • 点击“确定”保存。
  1. 验证：
  • 打开命令提示符（CMD）或 PowerShell。
  • 输入 zig version，应显示版本号（如 0.12.0）。

Linux 安装

  1. 下载 Zig：
  • 访问 Zig 下载页面。
  • 选择适用于 Linux 的版本（如 zig-linux-x86_64-0.12.0.tar.xz）。
  • 下载并解压到任意目录（如 ~/zig）：
    bash tar -xvf zig-linux-x86_64-0.12.0.tar.xz -C ~/zig
  1. 设置环境变量：
  • 编辑 shell 配置文件（如 ~/.bashrc 或 ~/.zshrc）。
  • 添加以下行：
    bash export PATH="$PATH:~/zig/zig-linux-x86_64-0.12.0"
  • 保存并应用：
    bash source ~/.bashrc
  1. 验证：
  • 在终端输入 zig version，应显示版本号。

可选：使用包管理器（如 snap）安装：

sudo snap install zig --classic --beta

macOS 安装

  1. 下载 Zig：
  • 访问 Zig 下载页面。
  • 选择适用于 macOS 的版本（如 zig-macos-x86_64-0.12.0.tar.xz）。
  • 下载并解压到任意目录（如 ~/zig）：
    bash tar -xvf zig-macos-x86_64-0.12.0.tar.xz -C ~/zig
  1. 设置环境变量：
  • 编辑 ~/.zshrc（macOS 默认使用 zsh）：
    bash export PATH="$PATH:~/zig/zig-macos-x86_64-0.12.0"
  • 保存并应用：
    bash source ~/.zshrc
  1. 验证：
  • 在终端输入 zig version，应显示版本号。

可选：使用 Homebrew 安装：

brew install zig

验证安装

无论哪种操作系统，验证步骤一致：

  • 打开终端，输入：
  zig version
  • 如果返回类似 0.12.0 的版本号，说明安装成功。

配置开发环境

为了更高效地编写 Zig 代码，推荐以下工具：

  1. 编辑器支持：
  • VS Code：安装 “Zig Language” 扩展。
  • Zig Language Server (ZLS)：提供自动补全和跳转功能：
    • 从 ZLS GitHub 下载或构建。
    • 配置编辑器指向 ZLS 可执行文件。
  1. 创建第一个程序：
  • 创建文件 hello.zig： const std = @import("std"); pub fn main() !void { const stdout = std.io.getStdOut().writer(); try stdout.print("Hello, Zig!\n", .{}); }
  • 运行：
    bash zig run hello.zig
  • 输出：Hello, Zig!

常见问题与解决

  • 问题：zig: command not found。
  • 解决：检查 PATH 是否正确设置，重新加载终端。
  • 问题：版本过旧。
  • 解决：从官网下载最新版本，替换旧文件。
  • 问题：ZLS 不工作。
  • 解决：确保 ZLS 与 Zig 版本兼容，检查配置路径。

如果您需要更具体的帮助（例如针对某操作系统或 IDE 的详细配置），请告诉我，我可以进一步调整内容！