---
title: "Como Instalar Zig no Arch Linux — Pacman, AUR e Manual"
url: "https://ziglang.com.br/instalacao/como-instalar-zig-no-arch-linux-pacman-aur-e-manual/"
markdown_url: "https://ziglang.com.br/instalacao/como-instalar-zig-no-arch-linux-pacman-aur-e-manual.MD"
description: "Instale o Zig no Arch Linux, Manjaro e EndeavourOS. Guia com pacman, AUR helpers, download manual e dicas de configuração."
date: "2026-02-21"
author: "Zig Brasil"
---

# Como Instalar Zig no Arch Linux — Pacman, AUR e Manual

Instale o Zig no Arch Linux, Manjaro e EndeavourOS. Guia com pacman, AUR helpers, download manual e dicas de configuração.


# 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](/instalacao/). Se você é novo no Zig, comece pela [introdução ao Zig](/tutoriais/introducao-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:

```bash
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

```bash
sudo pacman -S zig
```

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

### Passo 3: Verificar a Instalação

```bash
zig version
```

### Passo 4: Testar o Compilador

Crie um arquivo de teste:

```zig
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:

```bash
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:

```bash
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:

```bash
# 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`:

```bash
paru -S zig-dev-bin
```

### Instalação Manual do AUR

Se não usa um AUR helper:

```bash
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

```bash
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

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

### Passo 3: Configurar o PATH

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

Ou, se usa Zsh (comum no Arch):

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

Ou crie um link simbólico:

```bash
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

```bash
sudo pacman -S zls
```

### Via AUR (versão de desenvolvimento)

```bash
yay -S zls-git
```

### Verificar o ZLS

```bash
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](/instalacao/configurar-vscode-zig/)
- [Configurar Neovim para Zig](/instalacao/configurar-neovim-zig/)
- [Configurar Sublime Text e Emacs](/instalacao/configurar-sublime-emacs-zig/)

---

## Manjaro, EndeavourOS e Outros Derivados

### Manjaro

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

```bash
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:

```bash
sudo pacman -S zig
```

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

### Garuda Linux

```bash
sudo pacman -S zig
```

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

```bash
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:

```bash
# 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:

```bash
# 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`:

```ini
[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:

```bash
# 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:

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

---

## Desinstalação

### Via Pacman

```bash
# 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

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

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

### Instalação Manual

```bash
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](/instalacao/configurar-vscode-zig/) ou [Neovim](/instalacao/configurar-neovim-zig/)
2. **Crie seu primeiro projeto** — [Guia do primeiro projeto Zig](/instalacao/zig-primeiro-projeto/)
3. **Gerencie múltiplas versões** — [Gerenciar versões do Zig](/instalacao/zig-gerenciar-versoes/)
4. **Aprenda a linguagem** — [Introdução ao Zig](/tutoriais/introducao-ao-zig/)
5. **Veja exemplos práticos** — [Receitas](/receitas/)

Para configurar integração contínua nos seus projetos, confira o guia de [Zig com GitHub Actions](/instalacao/zig-ci-github-actions/).