Zig 环境配置

本章将指导你在不同操作系统上安装和配置 Zig 开发环境。

安装 Zig

方法一：官方下载（推荐）

Windows

访问 Zig 官方下载页面
下载适合你系统的版本（通常是 zig-windows-x86_64-*.zip）
解压到你选择的目录（如 C:\zig）
将 Zig 目录添加到系统 PATH 环境变量

添加到 PATH 的步骤：

# 临时添加（当前会话有效）
set PATH=%PATH%;C:\zig

# 永久添加：通过系统设置 -> 高级系统设置 -> 环境变量

macOS

# 下载并解压
curl -O https://ziglang.org/download/0.12.0/zig-macos-aarch64-0.12.0.tar.xz
tar -xf zig-macos-aarch64-0.12.0.tar.xz

# 移动到系统目录
sudo mv zig-macos-aarch64-0.12.0 /usr/local/zig

# 添加到 PATH
echo 'export PATH="/usr/local/zig:$PATH"' >> ~/.zshrc
source ~/.zshrc

Linux

# 下载并解压
wget https://ziglang.org/download/0.12.0/zig-linux-x86_64-0.12.0.tar.xz
tar -xf zig-linux-x86_64-0.12.0.tar.xz

# 移动到系统目录
sudo mv zig-linux-x86_64-0.12.0 /usr/local/zig

# 添加到 PATH
echo 'export PATH="/usr/local/zig:$PATH"' >> ~/.bashrc
source ~/.bashrc

方法二：包管理器安装

macOS (Homebrew)

brew install zig

Linux (各发行版)

# Ubuntu/Debian
sudo apt install zig

# Arch Linux
sudo pacman -S zig

# Fedora
sudo dnf install zig

Windows (Chocolatey)

choco install zig

方法三：从源码编译

如果你需要最新的开发版本：

git clone https://github.com/ziglang/zig.git
cd zig
mkdir build
cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make install

验证安装

安装完成后，验证 Zig 是否正确安装：

zig version

你应该看到类似这样的输出：

0.12.0

开发环境配置

文本编辑器和 IDE

Visual Studio Code（推荐）

安装 VS Code
安装 Zig 扩展：
- 打开扩展面板（Ctrl+Shift+X）
- 搜索 "Zig Language"
- 安装官方 Zig 扩展

推荐设置：

{
    "zig.path": "zig",
    "zig.zls.path": "zls",
    "zig.initialLogLevel": "info"
}

Vim/Neovim

" 安装 zig.vim 插件
Plug 'ziglang/zig.vim'

" 基本配置
autocmd BufNewFile,BufRead *.zig set filetype=zig
autocmd FileType zig setlocal shiftwidth=4 tabstop=4

Emacs

;; 安装 zig-mode
(use-package zig-mode
  :ensure t)

其他编辑器

Sublime Text：安装 Zig 语法高亮包
Atom：安装 language-zig 包
IntelliJ IDEA：安装 Zig 插件

Zig Language Server (ZLS)

ZLS 提供代码补全、错误检查、跳转定义等功能。

安装 ZLS

# 从源码编译安装
git clone https://github.com/zigtools/zls.git
cd zls
zig build -Doptimize=ReleaseSafe

配置 ZLS

创建 .zls.json 配置文件：

{
    "enable_snippets": true,
    "enable_ast_check_diagnostics": true,
    "enable_autofix": true,
    "enable_import_embedfile_argument_completions": true,
    "warn_style": true,
    "highlight_global_var_declarations": true
}

创建第一个 Zig 项目

项目结构

my-zig-project/
├── src/
│   └── main.zig
├── build.zig
└── build.zig.zon

初始化项目

# 创建项目目录
mkdir my-zig-project
cd my-zig-project

# 初始化 Zig 项目
zig init-exe

Hello World 程序

创建 src/main.zig：

const std = @import("std");

pub fn main() void {
    std.debug.print("Hello, Zig!\n", .{});
}

编译和运行

# 编译
zig build

# 运行
zig run src/main.zig

# 或者直接运行构建结果
./zig-out/bin/my-zig-project

常用 Zig 命令

基本命令

# 运行 Zig 文件
zig run main.zig

# 编译为可执行文件
zig build-exe main.zig

# 编译为库
zig build-lib main.zig

# 测试
zig test main.zig

# 格式化代码
zig fmt main.zig

# 检查语法
zig ast-check main.zig

构建选项

# 优化构建
zig build -Doptimize=ReleaseFast

# 调试构建
zig build -Doptimize=Debug

# 交叉编译
zig build -Dtarget=x86_64-linux-gnu

调试工具

GDB 调试

# 编译带调试信息的程序
zig build-exe -O Debug main.zig

# 使用 GDB 调试
gdb ./main

LLDB 调试

# 使用 LLDB 调试
lldb ./main

内置调试

Zig 提供了内置的调试功能：

const std = @import("std");

pub fn main() void {
    std.debug.print("调试信息: {}\n", .{42});
    
    // 断言
    std.debug.assert(1 + 1 == 2);
    
    // 恐慌（程序终止）
    // std.debug.panic("出现错误！", .{});
}

性能分析

内置性能分析

# 启用性能分析
zig build -Doptimize=ReleaseFast -Dcpu=native

外部工具

Valgrind（Linux）：内存检查
Instruments（macOS）：性能分析
Intel VTune：CPU 性能分析

常见问题解决

问题 1：找不到 zig 命令

解决方案：检查 PATH 环境变量是否正确设置

问题 2：编译错误

解决方案：

检查 Zig 版本兼容性
查看错误信息
参考官方文档

问题 3：ZLS 不工作

解决方案：

确保 ZLS 正确安装
检查编辑器配置
重启编辑器

总结

现在你已经成功配置了 Zig 开发环境！你应该能够：

✅ 安装和运行 Zig 编译器
✅ 配置代码编辑器
✅ 创建和运行 Zig 程序
✅ 使用基本的 Zig 命令

在下一章中，我们将学习 Zig 的基本语法，开始真正的编程之旅。

#Zig 环境配置

#安装 Zig

#方法一：官方下载（推荐）

#Windows

#macOS

#Linux

#方法二：包管理器安装

#macOS (Homebrew)

#Linux (各发行版)

#Windows (Chocolatey)

#方法三：从源码编译

#验证安装

#开发环境配置

#文本编辑器和 IDE

#Visual Studio Code（推荐）

#Vim/Neovim

#Emacs

#其他编辑器

#Zig Language Server (ZLS)

#安装 ZLS

#配置 ZLS

#创建第一个 Zig 项目

#项目结构

#初始化项目

#Hello World 程序

#编译和运行

#常用 Zig 命令

#基本命令

#构建选项

#调试工具

#GDB 调试

#LLDB 调试

#内置调试

#性能分析

#内置性能分析

#外部工具

#常见问题解决

#问题 1：找不到 zig 命令

#问题 2：编译错误

#问题 3：ZLS 不工作

#总结