zigup — O que é e Como Usar

Definição

zigup é um gerenciador de versões para o compilador Zig. Ele permite instalar, alternar e gerenciar múltiplas versões do Zig na mesma máquina. Similar ao rustup para Rust ou nvm para Node.js, o zigup simplifica o fluxo de trabalho quando você precisa trabalhar com diferentes versões do Zig em projetos distintos ou testar código em versões futuras.

Por que zigup Importa

1. Múltiplas versões: Manter Zig estável e nightly lado a lado.
2. Facilidade: Instalar e alternar versões com um único comando.
3. Reprodutibilidade: Garantir que cada projeto use a versão correta.
4. Atualizações: Acompanhar as versões mais recentes facilmente.

Instalação

Download Direto

# Linux/macOS — baixar o binário
curl -L https://github.com/marler/zigup/releases/latest/download/zigup-x86_64-linux.tar.xz | tar xJ

# Mover para o PATH
sudo mv zigup /usr/local/bin/

# macOS (Apple Silicon)
curl -L https://github.com/marler/zigup/releases/latest/download/zigup-aarch64-macos.tar.xz | tar xJ

Uso Básico

Instalar uma Versão

# Instalar versão estável mais recente
zigup fetch 0.13.0

# Instalar versão nightly (master)
zigup fetch master

# Definir versão padrão
zigup default 0.13.0

Alternar entre Versões

# Ver versões instaladas
zigup list

# Mudar a versão padrão
zigup default 0.13.0

# Verificar versão ativa
zig version

Remover Versões

# Remover versão específica
zigup clean 0.12.0

# Manter apenas a versão padrão
zigup clean --keep-default

Comandos Principais

Exemplo Prático

# Fluxo típico de trabalho

# 1. Instalar a versão estável para trabalho diário
zigup fetch 0.13.0
zigup default 0.13.0

# 2. Testar com versão nightly para verificar compatibilidade
zigup fetch master
zigup run master -- zig build test

# 3. Verificar qual versão está ativa
zig version  # 0.13.0

Armadilhas Comuns

• PATH: O zigup precisa estar no PATH e o diretório de instalação do Zig também.
• ZLS compatível: Ao trocar de versão do Zig, atualize o ZLS para a versão correspondente.
• Nightly muda diariamente: A versão master é atualizada com frequência. Código que funciona hoje pode quebrar amanhã.
• Espaço em disco: Cada versão do Zig ocupa cerca de 150MB. Limpe versões não utilizadas com zigup clean.

Termos Relacionados

• ZLS — Language Server que deve ser compatível com a versão do Zig
• Zig Software Foundation — Organização que mantém o Zig
• build.zig — Pode especificar versão mínima do Zig
• build.zig.zon — Campo minimum_zig_version

Tutoriais Relacionados

• Configurando o Ambiente Zig
• Introdução ao Zig
• Zig para Iniciantes