Zig 环境配置
本章将指导你在不同操作系统上安装和配置 Zig 开发环境。
安装 Zig
方法一：官方下载（推荐）
Windows
- 访问 Zig 官方下载页面
- 下载适合你系统的版本（通常是
zig-windows-x86_64-*.zip） - 解压到你选择的目录（如
C:\zig） - 将 Zig 目录添加到系统 PATH 环境变量
添加到 PATH 的步骤：
cmd
# 临时添加（当前会话有效）
set PATH=%PATH%;C:\zig
# 永久添加：通过系统设置 -> 高级系统设置 -> 环境变量macOS
bash
# 下载并解压
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 ~/.zshrcLinux
bash
# 下载并解压
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)
bash
brew install zigLinux (各发行版)
bash
# Ubuntu/Debian
sudo apt install zig
# Arch Linux
sudo pacman -S zig
# Fedora
sudo dnf install zigWindows (Chocolatey)
powershell
choco install zig方法三：从源码编译
如果你需要最新的开发版本：
bash
git clone https://github.com/ziglang/zig.git
cd zig
mkdir build
cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make install验证安装
安装完成后，验证 Zig 是否正确安装：
bash
zig version你应该看到类似这样的输出：
0.12.0开发环境配置
文本编辑器和 IDE
Visual Studio Code（推荐）
- 安装 VS Code
- 安装 Zig 扩展：
- 打开扩展面板（Ctrl+Shift+X）
- 搜索 "Zig Language"
- 安装官方 Zig 扩展
推荐设置：
json
{
"zig.path": "zig",
"zig.zls.path": "zls",
"zig.initialLogLevel": "info"
}Vim/Neovim
vim
" 安装 zig.vim 插件
Plug 'ziglang/zig.vim'
" 基本配置
autocmd BufNewFile,BufRead *.zig set filetype=zig
autocmd FileType zig setlocal shiftwidth=4 tabstop=4Emacs
elisp
;; 安装 zig-mode
(use-package zig-mode
:ensure t)其他编辑器
- Sublime Text：安装 Zig 语法高亮包
- Atom：安装 language-zig 包
- IntelliJ IDEA：安装 Zig 插件
Zig Language Server (ZLS)
ZLS 提供代码补全、错误检查、跳转定义等功能。
安装 ZLS
bash
# 从源码编译安装
git clone https://github.com/zigtools/zls.git
cd zls
zig build -Doptimize=ReleaseSafe配置 ZLS
创建 .zls.json 配置文件：
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初始化项目
bash
# 创建项目目录
mkdir my-zig-project
cd my-zig-project
# 初始化 Zig 项目
zig init-exeHello World 程序
创建 src/main.zig：
zig
const std = @import("std");
pub fn main() void {
std.debug.print("Hello, Zig!\n", .{});
}编译和运行
bash
# 编译
zig build
# 运行
zig run src/main.zig
# 或者直接运行构建结果
./zig-out/bin/my-zig-project常用 Zig 命令
基本命令
bash
# 运行 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构建选项
bash
# 优化构建
zig build -Doptimize=ReleaseFast
# 调试构建
zig build -Doptimize=Debug
# 交叉编译
zig build -Dtarget=x86_64-linux-gnu调试工具
GDB 调试
bash
# 编译带调试信息的程序
zig build-exe -O Debug main.zig
# 使用 GDB 调试
gdb ./mainLLDB 调试
bash
# 使用 LLDB 调试
lldb ./main内置调试
Zig 提供了内置的调试功能：
zig
const std = @import("std");
pub fn main() void {
std.debug.print("调试信息: {}\n", .{42});
// 断言
std.debug.assert(1 + 1 == 2);
// 恐慌（程序终止）
// std.debug.panic("出现错误！", .{});
}性能分析
内置性能分析
bash
# 启用性能分析
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 的基本语法，开始真正的编程之旅。