---
title: "Como Instalar Zig no Ubuntu e Debian — Guia Passo a Passo"
url: "https://ziglang.com.br/instalacao/como-instalar-zig-no-ubuntu-e-debian-guia-passo-a-passo/"
markdown_url: "https://ziglang.com.br/instalacao/como-instalar-zig-no-ubuntu-e-debian-guia-passo-a-passo.MD"
description: "Aprenda a instalar o Zig no Ubuntu, Debian, Linux Mint e Pop!_OS. Guia completo com snap, download manual e verificação da instalação."
date: "2026-02-21"
author: "Zig Brasil"
---

# Como Instalar Zig no Ubuntu e Debian — Guia Passo a Passo

Aprenda a instalar o Zig no Ubuntu, Debian, Linux Mint e Pop!_OS. Guia completo com snap, download manual e verificação da instalação.


# 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](/tutoriais/introducao-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](/instalacao/).

---

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

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

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

Para sistemas **aarch64** (ARM64):

```bash
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](https://ziglang.org/download/) para obter o link da versão mais recente.

### Passo 3: Extrair o Arquivo

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

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

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

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

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

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

```bash
zig version
```

Saída esperada:

```
0.14.0
```

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

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

Crie um arquivo `main.zig`:

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

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

```bash
sudo apt update
sudo apt install snapd
```

### Passo 2: Instalar o Zig

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

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

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

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

```bash
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](/instalacao/zig-compilar-do-fonte/). As dependências incluem:

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

---

## Desinstalando o Zig

### Se instalou via download direto:

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

### Se instalou via Snap:

```bash
sudo snap remove zig
```

---

## Problemas Comuns

### "zig: command not found"

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

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

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

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

```bash
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](/instalacao/zig-compilar-do-fonte/)

Para mais soluções, visite nossa página de [erros comuns](/erros/).

---

## 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](/instalacao/zig-gerenciar-versoes/) 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](/instalacao/configurar-vscode-zig/) ou o [Neovim](/instalacao/configurar-neovim-zig/) para ter autocompletar e diagnósticos
2. **Criar seu primeiro projeto** — Siga nosso [guia do primeiro projeto Zig](/instalacao/zig-primeiro-projeto/)
3. **Aprender a linguagem** — Leia o [tutorial de introdução ao Zig](/tutoriais/introducao-ao-zig/)
4. **Ver exemplos práticos** — Explore nossas [receitas](/receitas/) com código funcional

Se estiver usando Ubuntu dentro do WSL no Windows, confira nosso guia específico para [Zig no WSL](/instalacao/instalar-zig-wsl/).