Como Instalar Zig no Ubuntu e Debian

Este guia cobre a instalação do compilador Zig em distribuições Linux baseadas em Debian, incluindo Ubuntu, Debian, Linux Mint, Pop!_OS e elementary OS. Vamos apresentar três métodos: download direto do site oficial (recomendado), instalação via Snap e compilação do código-fonte.

Se você ainda não conhece o Zig, recomendamos ler a introdução ao Zig antes de começar. Se preferir uma visão geral de todas as opções de instalação, visite nosso guia completo de instalação.

Método 1: Download Direto (Recomendado)

O método mais confiável para instalar o Zig no Ubuntu/Debian é baixar o binário pré-compilado diretamente do site oficial. Isso garante que você tenha a versão mais recente disponível.

Passo 1: Verificar a Arquitetura do Sistema

Primeiro, descubra a arquitetura do seu processador:

uname -m

Os resultados mais comuns são:

• x86_64 — Processadores Intel/AMD de 64 bits
• aarch64 — Processadores ARM de 64 bits (Raspberry Pi 4+, servidores ARM)

Passo 2: Baixar o Zig

Para sistemas x86_64, execute:

curl -LO https://ziglang.org/download/0.14.0/zig-linux-x86_64-0.14.0.tar.xz

Para sistemas aarch64 (ARM64):

curl -LO https://ziglang.org/download/0.14.0/zig-linux-aarch64-0.14.0.tar.xz

Nota: Verifique a página oficial de downloads do Zig para obter o link da versão mais recente.

Passo 3: Extrair o Arquivo

tar -xf zig-linux-x86_64-0.14.0.tar.xz

Passo 4: Mover para um Diretório do Sistema

É uma boa prática mover o Zig para /opt ou /usr/local:

sudo mv zig-linux-x86_64-0.14.0 /opt/zig

Passo 5: Adicionar ao PATH

Para que o comando zig funcione em qualquer lugar do terminal, adicione-o ao PATH. Edite o arquivo ~/.bashrc (ou ~/.zshrc se usar Zsh):

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

Se você usa Zsh (padrão em algumas distribuições):

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

Passo 6: Verificar a Instalação

zig version

Saída esperada:

0.14.0

Para um teste mais completo, compile e execute um programa simples:

mkdir -p /tmp/zig-teste && cd /tmp/zig-teste

Crie um arquivo main.zig:

const std = @import("std");

pub fn main() !void {
    const stdout = std.io.getStdOut().writer();
    try stdout.print("Olá do Zig no Ubuntu! Versão: {}\n", .{@import("builtin").zig_version});
}

Compile e execute:

zig run main.zig

Método 2: Instalação via Snap

O Snap é um sistema de pacotes universal disponível no Ubuntu por padrão. A instalação via Snap é simples, mas pode não ter a versão mais recente do Zig.

Passo 1: Instalar o Snap (se necessário)

Na maioria das instalações do Ubuntu, o Snap já está disponível. No Debian ou Linux Mint, pode ser necessário instalar:

sudo apt update
sudo apt install snapd

Passo 2: Instalar o Zig

sudo snap install zig --classic --beta

O parâmetro --classic é necessário porque o Zig precisa de acesso ao sistema de arquivos para compilação.

Passo 3: Verificar a Instalação

zig version

Vantagens e Desvantagens do Snap

Vantagens:

• Instalação com um único comando
• Atualizações automáticas
• Desinstalação limpa com sudo snap remove zig

Desvantagens:

• Pode não ter a versão mais recente
• Startup ligeiramente mais lento que o binário nativo
• Requer o daemon snapd rodando

Método 3: Usando o Script de Instalação Automática

Você pode criar um script que automatiza o download e a instalação do Zig. Esse método é útil para configurar múltiplas máquinas ou para uso em scripts de provisionamento:

#!/bin/bash
set -euo pipefail

ZIG_VERSION="0.14.0"
ARCH=$(uname -m)
INSTALL_DIR="/opt/zig"

echo "Instalando Zig ${ZIG_VERSION} para ${ARCH}..."

# Baixar
curl -LO "https://ziglang.org/download/${ZIG_VERSION}/zig-linux-${ARCH}-${ZIG_VERSION}.tar.xz"

# Verificar integridade (opcional, mas recomendado)
echo "Extraindo..."
tar -xf "zig-linux-${ARCH}-${ZIG_VERSION}.tar.xz"

# Instalar
sudo rm -rf "${INSTALL_DIR}"
sudo mv "zig-linux-${ARCH}-${ZIG_VERSION}" "${INSTALL_DIR}"

# Criar link simbólico
sudo ln -sf "${INSTALL_DIR}/zig" /usr/local/bin/zig

# Verificar
echo "Zig instalado com sucesso!"
zig version

# Limpar
rm -f "zig-linux-${ARCH}-${ZIG_VERSION}.tar.xz"

Salve este script como instalar-zig.sh, torne-o executável e execute:

chmod +x instalar-zig.sh
sudo ./instalar-zig.sh

A vantagem do link simbólico em /usr/local/bin/ é que esse diretório já está no PATH da maioria das distribuições, então não é necessário modificar o .bashrc.

Instalando Dependências para Desenvolvimento

Embora o Zig seja distribuído como um binário estático e não precise de dependências externas para funcionar, algumas situações exigem pacotes adicionais:

Para interoperabilidade com C

O Zig tem um compilador C embutido e pode compilar código C diretamente. No entanto, para linkar com bibliotecas do sistema, você pode precisar dos headers de desenvolvimento:

sudo apt update
sudo apt install build-essential linux-headers-$(uname -r)

Para compilar o Zig do código-fonte

Se quiser compilar o Zig a partir do código-fonte, consulte nosso guia de compilação do Zig. As dependências incluem:

sudo apt install cmake llvm-18 llvm-18-dev libclang-18-dev liblld-18-dev

Desinstalando o Zig

Se instalou via download direto:

sudo rm -rf /opt/zig
# Remova a linha do PATH do ~/.bashrc ou ~/.zshrc

Se instalou via Snap:

sudo snap remove zig

Problemas Comuns

“zig: command not found”

Isso geralmente indica que o PATH não foi configurado corretamente. Verifique:

echo $PATH | tr ':' '\n' | grep zig

Se não aparecer nenhum resultado, adicione o caminho novamente:

export PATH="/opt/zig:$PATH"

E não esqueça de adicionar ao seu ~/.bashrc para persistir entre sessões.

Erro de permissão ao executar

Se receber “Permission denied”, torne o binário executável:

chmod +x /opt/zig/zig

Versão antiga do GLIBC

Em versões muito antigas do Ubuntu (18.04 ou anterior), pode haver incompatibilidade com a versão do GLIBC. Nesse caso, considere:

• Atualizar o sistema operacional
• Usar uma versão mais antiga do Zig que suporte sua versão do GLIBC
• Compilar o Zig do código-fonte

Para mais soluções, visite nossa página de erros comuns.

Atualizando o Zig

Para atualizar o Zig instalado manualmente, basta repetir os passos do Método 1 com a versão mais recente. Você pode automatizar isso com o script do Método 3.

Se você trabalha com múltiplos projetos que exigem versões diferentes do Zig, confira nosso guia sobre gerenciamento de versões do Zig com o zigup.

Próximos Passos

Com o Zig instalado no seu Ubuntu/Debian, recomendamos:

1. Configurar seu editor — Veja como configurar o VS Code ou o Neovim para ter autocompletar e diagnósticos
2. Criar seu primeiro projeto — Siga nosso guia do primeiro projeto Zig
3. Aprender a linguagem — Leia o tutorial de introdução ao Zig
4. Ver exemplos práticos — Explore nossas receitas com código funcional

Se estiver usando Ubuntu dentro do WSL no Windows, confira nosso guia específico para Zig no WSL.