Zig安装与配置 #

一、安装前的准备 #

1.1 系统要求 #

操作系统	最低版本	架构支持
Windows	Windows 7	x86_64
macOS	10.13 (High Sierra)	x86_64, aarch64
Linux	内核 3.10+	x86_64, aarch64, arm

1.2 依赖项 #

Zig是自包含的，几乎不需要外部依赖：

Windows：无需额外依赖
macOS：Xcode命令行工具（可选，用于链接系统库）
Linux：glibc 或 musl libc

二、Windows安装 #

2.1 下载安装 #

方法一：官网下载

访问 Zig官网下载页面
下载 Windows 版本的压缩包（如 zig-windows-x86_64-0.13.0.zip）
解压到目标目录（如 C:\zig）

方法二：使用包管理器

使用 Scoop：

powershell

scoop install zig

使用 Chocolatey：

powershell

choco install zig

使用 Winget：

powershell

winget install zig.zig

2.2 配置环境变量 #

右键"此电脑" → “属性” → “高级系统设置”
点击"环境变量"
在"系统变量"中找到 Path，点击"编辑"
添加 Zig 的 bin 目录路径（如 C:\zig）
点击"确定"保存

Powerhell 设置（临时）：

powershell

$env:Path += ";C:\zig"

2.3 验证安装 #

打开命令提示符或PowerShell：

powershell

zig version

输出类似：

text

0.13.0

三、macOS安装 #

3.1 下载安装 #

方法一：官网下载

访问 Zig官网下载页面
下载 macOS 版本的压缩包
解压并移动到目标目录：

bash

tar -xzf zig-macos-x86_64-0.13.0.tar.xz
sudo mv zig-macos-x86_64-0.13.0 /usr/local/zig

方法二：使用 Homebrew

bash

brew install zig

方法三：使用 MacPorts

bash

sudo port install zig

3.2 配置环境变量 #

如果使用官网下载，需要添加到 PATH：

bash

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

3.3 验证安装 #

bash

zig version

四、Linux安装 #

4.1 下载安装 #

方法一：官网下载

bash

# 下载
wget https://ziglang.org/download/0.13.0/zig-linux-x86_64-0.13.0.tar.xz

# 解压
tar -xzf zig-linux-x86_64-0.13.0.tar.xz

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

方法二：使用包管理器

Ubuntu/Debian：

bash

sudo apt update
sudo apt install zig

Arch Linux：

bash

sudo pacman -S zig

Fedora：

bash

sudo dnf install zig

Void Linux：

bash

sudo xbps-install zig

方法三：使用 Snap

bash

sudo snap install zig --classic --beta

4.2 配置环境变量 #

bash

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

4.3 验证安装 #

bash

zig version

五、从源码编译 #

5.1 获取源码 #

bash

git clone https://github.com/ziglang/zig.git
cd zig

5.2 编译依赖 #

需要以下工具：

CMake 3.15+
C++ 编译器（GCC、Clang 或 MSVC）
LLVM（可选，用于优化后端）

5.3 编译步骤 #

bash

mkdir build
cd build
cmake ..
make -j$(nproc)
sudo make install

六、开发工具配置 #

6.1 VS Code 配置 #

安装 VS Code
安装 Zig 扩展：
- 搜索 “Zig” 扩展并安装
- 推荐扩展：ziglang.vscode-zig
配置 settings.json：

json

{
    "zig.path": "/usr/local/zig/zig",
    "zig.formatting.provider": "zig",
    "zig.checkForUpdate": false
}

6.2 ZLS（Zig Language Server） #

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

安装 ZLS：

bash

# 使用 Zig 自带安装
zig build -Doptimize=ReleaseFast

# 或下载预编译版本
# https://github.com/zigtools/zls/releases

VS Code 配置 ZLS：

json

{
    "zig.zls.path": "/path/to/zls"
}

6.3 其他编辑器 #

Neovim：

使用 nvim-lspconfig 配置 ZLS：

lua

local lspconfig = require('lspconfig')
lspconfig.zls.setup({})

Emacs：

使用 zig-mode 和 lsp-mode：

elisp

(use-package zig-mode
  :hook ((zig-mode . lsp-deferred)))

Vim：

使用 vim-zig 插件。

七、构建工具 #

7.1 Zig 内置构建系统 #

Zig 自带强大的构建系统：

bash

# 初始化项目
zig init

# 构建项目
zig build

# 运行项目
zig build run

# 运行测试
zig build test

7.2 项目结构 #

text

my-project/
├── build.zig      # 构建脚本
├── build.zig.zon  # 依赖配置
└── src/
    └── main.zig   # 主程序

八、常用命令 #

8.1 编译命令 #

bash

# 编译并运行
zig run main.zig

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

# 编译为静态库
zig build-lib mylib.zig -static

# 编译为动态库
zig build-lib mylib.zig -dynamic

8.2 交叉编译 #

bash

# 编译为 Linux
zig build-exe main.zig -target x86_64-linux-gnu

# 编译为 Windows
zig build-exe main.zig -target x86_64-windows-gnu

# 编译为 macOS
zig build-exe main.zig -target aarch64-macos-none

8.3 其他命令 #

bash

# 格式化代码
zig fmt main.zig

# 运行测试
zig test main.zig

# 查看帮助
zig --help

九、验证开发环境 #

创建测试文件 hello.zig：

zig

const std = @import("std");

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

运行测试：

bash

zig run hello.zig

输出：

text

Hello, Zig!

十、常见问题 #

10.1 找不到 zig 命令 #

确保 Zig 路径已添加到 PATH 环境变量中。

10.2 权限问题 #

在 Linux/macOS 上，确保有执行权限：

bash

chmod +x /usr/local/zig/zig

10.3 版本不匹配 #

确保使用最新稳定版本：

bash

zig version

十一、总结 #

安装 Zig 的关键步骤：

步骤	说明
下载	从官网或包管理器获取
解压	解压到目标目录
配置PATH	添加到环境变量
验证	运行 `zig version`
配置编辑器	安装 VS Code 扩展和 ZLS

下一步，让我们编写第一个 Zig 程序！