eloitor/zig

docker-zig Docker镜像文档

镜像概述

docker-zig是一个专为Zig编程语言设计的Docker镜像，旨在提供开箱即用的开发环境。该镜像基于轻量级Linux基础镜像构建，集成了Zig编译器、标准库、构建工具及相关依赖，消除了手动安装配置Zig工具链的复杂性，使开发者能够快速投入Zig项目开发、学习或集成到自动化流程中。

核心功能与特性

• 完整工具链：包含最新稳定版Zig编译器（zig）、标准库及全套开发工具（如zig build、zig run、zig test等）
• 轻量级设计：基于Alpine Linux构建，镜像体积小，启动速度快，资源占用低
• 即开即用：无需额外配置，拉取镜像后可直接执行Zig命令，简化环境搭建流程
• 环境隔离：提供独立的Zig运行环境，避免与系统本地工具链冲突，确保开发环境一致性
• 版本可控：通过镜像标签支持多版本Zig（如0.11.0、0.12.0），满足不同项目的版本需求

使用场景

• Zig应用开发：快速创建、编译和测试Zig应用程序，支持命令行工具、系统软件等开发
• Zig语言学习：为初学者提供无配置门槛的学习环境，专注于语言本身而非环境搭建
• CI/CD集成：作为自动化构建流程的基础环境，用于Zig项目的持续集成和测试
• 多版本测试：通过切换镜像标签，便捷测试项目在不同Zig版本下的兼容性

使用方法

基本使用

拉取并运行镜像，验证Zig环境：

bash
# 拉取最新版本镜像（默认标签latest）
docker pull docker.xuanyuan.run/eloitor/docker-zig

# 查看Zig版本，验证环境
docker run --rm docker.xuanyuan.run/eloitor/docker-zig zig version

开发本地项目

挂载本地Zig项目目录到容器，进行开发和构建：

bash
# 假设本地项目位于当前目录的./my-zig-project
docker run -it --rm -v "$(pwd)/my-zig-project:/app" docker.xuanyuan.run/eloitor/docker-zig sh

# 进入容器后，在/app目录下操作项目
cd /app
zig init-exe       # 初始化可执行程序项目（生成build.zig和src/main.zig）
zig build          # 构建项目
zig run src/main.zig  # 直接运行源代码
zig test           # 运行测试用例

指定Zig版本

通过镜像标签使用特定版本的Zig（标签对应Zig版本号）：

bash
# 使用Zig 0.12.0版本
docker run --rm docker.xuanyuan.run/eloitor/docker-zig:0.12.0 zig version

环境变量配置

镜像支持以下环境变量自定义行为：

• ZIG_CACHE_DIR：指定Zig缓存目录（默认：/root/.cache/zig）
• ZIG_GLOBAL_CACHE_DIR：指定全局缓存目录（默认：/root/.cache/zig/global）

示例：自定义缓存目录并持久化

bash
# 挂载本地缓存目录，避免重复下载依赖
docker run -it --rm \
  -v "$(pwd)/my-zig-project:/app" \
  -v "$(pwd)/zig-cache:/root/.cache/zig" \
  -e ZIG_CACHE_DIR=/root/.cache/zig \
  docker.xuanyuan.run/eloitor/docker-zig sh

注意事项

• 本地目录挂载时，确保容器内用户（默认root）对挂载目录有读写权限，避免权限错误
• 生产环境建议使用特定版本标签（如0.12.0）而非latest，确保构建一致性
• 如需跨平台编译，可结合Zig的交叉编译功能（zig build -Dtarget=<target-triple>）在容器内完成

维护与更新

镜像会定期更新以包含最新稳定版Zig及安全补丁，版本变更记录可通过https://github.com/Eloitor/docker-zig%E6%9F%A5%E7%9C%8B%E3%80%82