Como Instalar Zig no Arch Linux

O Arch Linux é uma das melhores distribuições para desenvolvimento com Zig, graças aos seus repositórios sempre atualizados e à filosofia de manter pacotes nas versões mais recentes. Este guia cobre a instalação do Zig no Arch Linux e em derivados como Manjaro, EndeavourOS, Garuda Linux e ArcoLinux.

Para uma visão geral de todas as plataformas, consulte o guia completo de instalação. Se você é novo no Zig, comece pela introdução ao Zig.

Método 1: Pacman — Repositórios Oficiais (Recomendado)

O Zig está disponível nos repositórios oficiais do Arch Linux (extra). Esta é a forma mais simples e recomendada de instalação.

Passo 1: Atualizar o Sistema

Antes de instalar qualquer pacote no Arch, sempre atualize o sistema:

sudo pacman -Syu

Importante: No Arch Linux, nunca instale pacotes sem atualizar o sistema antes (-Sy sem -u). Isso pode causar problemas de dependências parciais.

Passo 2: Instalar o Zig

sudo pacman -S zig

O pacman vai resolver as dependências automaticamente e instalar o Zig.

Passo 3: Verificar a Instalação

zig version

Passo 4: Testar o Compilador

Crie um arquivo de teste:

const std = @import("std");

pub fn main() !void {
    const stdout = std.io.getStdOut().writer();
    try stdout.print("Zig instalado com sucesso no Arch Linux!\n", .{});

    // Demonstração de arrays e slices
    const numeros = [_]u32{ 10, 20, 30, 40, 50 };
    var soma: u32 = 0;
    for (numeros) |n| {
        soma += n;
    }
    try stdout.print("Soma dos números: {}\n", .{soma});
}

Compile e execute:

zig run teste.zig

Saída esperada:

Zig instalado com sucesso no Arch Linux!
Soma dos números: 150

Informações do Pacote

Para ver detalhes sobre o pacote instalado:

pacman -Qi zig

Isso mostra a versão, tamanho, dependências e outras informações úteis.

Método 2: AUR — Versões Alternativas

O AUR (Arch User Repository) oferece pacotes adicionais mantidos pela comunidade, incluindo versões de desenvolvimento do Zig.

Pacotes Disponíveis no AUR

• zig-dev-bin — Versão de desenvolvimento (nightly) do Zig, binário pré-compilado
• zig-git — Zig compilado a partir do código-fonte do repositório Git (master)

Instalando com yay

Se você usa o yay como AUR helper:

# Versão nightly (binário pré-compilado)
yay -S zig-dev-bin

# Versão compilada do código-fonte (demora mais)
yay -S zig-git

Instalando com paru

Se prefere o paru:

paru -S zig-dev-bin

Instalação Manual do AUR

Se não usa um AUR helper:

git clone https://aur.archlinux.org/zig-dev-bin.git
cd zig-dev-bin
makepkg -si

O makepkg -si compila o pacote e instala com o pacman, incluindo dependências automaticamente.

Quando Usar a Versão do AUR?

• zig-dev-bin: Quando você precisa de features da versão de desenvolvimento que ainda não estão na versão estável, ou quando quer testar as últimas novidades
• zig-git: Quando você quer a versão mais recente possível do master, ou quando contribui para o desenvolvimento do Zig

Aviso: Versões de desenvolvimento podem conter bugs e APIs instáveis. Para projetos em produção, prefira a versão estável dos repositórios oficiais.

Método 3: Download Manual

Se preferir gerenciar a instalação manualmente, sem usar o pacman:

Passo 1: Baixar

ZIG_VERSION="0.14.0"
ARCH=$(uname -m)
curl -LO "https://ziglang.org/download/${ZIG_VERSION}/zig-linux-${ARCH}-${ZIG_VERSION}.tar.xz"

Passo 2: Extrair e Instalar

tar -xf "zig-linux-${ARCH}-${ZIG_VERSION}.tar.xz"
sudo mv "zig-linux-${ARCH}-${ZIG_VERSION}" /opt/zig

Passo 3: Configurar o PATH

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

Ou, se usa Zsh (comum no Arch):

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

Ou crie um link simbólico:

sudo ln -sf /opt/zig/zig /usr/local/bin/zig

Instalando o ZLS (Zig Language Server)

O ZLS é essencial para ter autocompletar, diagnósticos e navegação de código no seu editor. No Arch Linux, ele também está disponível nos repositórios e no AUR:

Via Pacman

sudo pacman -S zls

Via AUR (versão de desenvolvimento)

yay -S zls-git

Verificar o ZLS

zls --version

O ZLS deve ser compatível com a versão do Zig que você instalou. Se usar o Zig estável, use o ZLS estável. Se usar o Zig nightly, use o zls-git.

Depois de instalar o ZLS, configure seu editor seguindo nossos guias:

• Configurar VS Code para Zig
• Configurar Neovim para Zig
• Configurar Sublime Text e Emacs

Manjaro, EndeavourOS e Outros Derivados

Manjaro

O Manjaro usa os mesmos repositórios do Arch, com um pequeno atraso nas atualizações para estabilidade:

sudo pacman -Syu zig

O Manjaro também suporta AUR, então os métodos com yay ou paru funcionam da mesma forma.

EndeavourOS

O EndeavourOS é essencialmente Arch Linux com um instalador gráfico. Todos os métodos deste guia funcionam diretamente:

sudo pacman -S zig

O yay já vem pré-instalado no EndeavourOS, facilitando o acesso ao AUR.

Garuda Linux

sudo pacman -S zig

O Garuda usa o paru como AUR helper padrão:

paru -S zig-dev-bin

Dicas para Desenvolvimento no Arch Linux

Cache do Pacman

O pacman mantém um cache de pacotes baixados. Para limpar versões antigas e liberar espaço:

# Manter apenas a versão atual no cache
sudo pacman -Sc

# Ou usar o paccache para manter as últimas 3 versões
sudo paccache -r

Downgrade do Zig

Se uma atualização do Zig causar problemas, você pode reverter para a versão anterior usando o cache do pacman:

# Listar versões no cache
ls /var/cache/pacman/pkg/zig-*

# Instalar uma versão específica do cache
sudo pacman -U /var/cache/pacman/pkg/zig-0.13.0-1-x86_64.pkg.tar.zst

Para impedir que o Zig seja atualizado automaticamente (útil durante desenvolvimento de projetos importantes), adicione ao /etc/pacman.conf:

IgnorePkg = zig

Hooks do Pacman

Você pode criar um hook para o pacman que notifique sobre atualizações do Zig. Crie o arquivo /etc/pacman.d/hooks/zig-update.hook:

[Trigger]
Operation = Upgrade
Type = Package
Target = zig

[Action]
Description = Zig foi atualizado! Verifique a compatibilidade dos seus projetos.
When = PostTransaction
Exec = /usr/bin/zig version

Usando o Zig com o Compilador C do Arch

O Zig pode substituir o GCC ou Clang como compilador C no Arch Linux. Isso é útil para cross-compilation:

# Em vez de gcc
zig cc -o programa programa.c

# Cross-compilar para Windows
zig cc --target=x86_64-windows-gnu -o programa.exe programa.c

# Cross-compilar para macOS
zig cc --target=x86_64-macos -o programa programa.c

Para usar o Zig como compilador padrão em projetos com Makefile:

make CC="zig cc" CXX="zig c++"

Desinstalação

Via Pacman

# Remover o Zig e suas dependências não utilizadas
sudo pacman -Rns zig

# Se instalou o ZLS também
sudo pacman -Rns zls

Via AUR

# Se instalou via yay
yay -Rns zig-dev-bin

# Se instalou via paru
paru -Rns zig-dev-bin

Instalação Manual

sudo rm -rf /opt/zig
sudo rm -f /usr/local/bin/zig

Próximos Passos

Com o Zig instalado no Arch Linux:

1. Configure o ZLS para seu editor preferido — VS Code ou Neovim
2. Crie seu primeiro projeto — Guia do primeiro projeto Zig
3. Gerencie múltiplas versões — Gerenciar versões do Zig
4. Aprenda a linguagem — Introdução ao Zig
5. Veja exemplos práticos — Receitas

Para configurar integração contínua nos seus projetos, confira o guia de Zig com GitHub Actions.