Como instalar Zig no Windows, Linux e macOS

Para instalar Zig, baixe o compilador em ziglang.org/download, escolha o arquivo do seu sistema e arquitetura, extraia a pasta e adicione essa pasta ao PATH. Abra um novo terminal e execute zig version para confirmar. No macOS, quem já usa Homebrew pode instalar com brew install zig. Abaixo, escolha o guia da sua plataforma e valide a instalação com um programa mínimo.

Se está começando, prefira uma versão estável; se vai executar um projeto existente, use a versão indicada no README ou na configuração de CI desse projeto. A biblioteca padrão e o sistema de build podem mudar entre versões: um exemplo escrito para outra versão pode precisar de ajustes.

Este índice ajuda a escolher o método e encontrar o passo a passo adequado. Para conhecer a linguagem antes de instalar, veja O que é Zig?.

Instalação por Sistema Operacional

Escolha seu sistema operacional para seguir o guia de instalação adequado:

Linux

• Instalar Zig no Ubuntu/Debian — Guia completo para distribuições baseadas em Debian, incluindo Ubuntu, Linux Mint e Pop!_OS. Cobre instalação via snap, download manual e compilação.

• Instalar Zig no Fedora/RHEL — Instruções para Fedora, CentOS Stream, RHEL e derivados. Inclui instalação via dnf e download direto.

• Instalar Zig no Arch Linux — Guia para Arch Linux e derivados como Manjaro e EndeavourOS. Cobre pacman, AUR e instalação manual.

macOS

• Instalar Zig no macOS — Instalação via Homebrew, MacPorts e download manual. Suporte para Intel e Apple Silicon (M1/M2/M3/M4).

Windows

• Instalar Zig no Windows — Guia completo com Scoop, Chocolatey, WinGet e instalação manual. Configuração do PATH e integração com o sistema.

• Instalar Zig no WSL — Como usar o Zig no Windows Subsystem for Linux. Ideal para quem quer um ambiente Linux dentro do Windows.

Containers e Gerenciadores de Pacotes

• Usar Zig com Docker — Ambientes em containers para desenvolvimento e CI/CD. Verifique a origem da imagem e fixe a versão do compilador.

• Instalar Zig com Nix — Instalação reprodutível com o gerenciador de pacotes Nix e NixOS. Inclui flakes e configuração de ambiente.

Configuração de Editores

Depois de instalar o Zig, configure seu editor para ter autocomplete, diagnóstico de erros e formatação automática:

• Configurar VS Code para Zig — Extensão oficial, ZLS (Zig Language Server), debug e produtividade no Visual Studio Code.

• Configurar Neovim para Zig — Configuração com LSP nativo, Tree-sitter, e plugins essenciais para desenvolvimento Zig no Neovim.

• Configurar Sublime Text e Emacs para Zig — Guias para Sublime Text, Emacs, e outros editores populares.

Primeiros Passos e Gerenciamento

Com o Zig instalado e o editor configurado, avance para os próximos passos:

• Aprender Zig do zero — Primeira sequência prática com zig run, zig init, const, var, tipos, funções e fluxo de controle.

• Criar seu Primeiro Projeto Zig — Estrutura de diretórios, build.zig, seu primeiro “Hello World” e como compilar e executar programas.

• Gerenciar Versões do Zig — Como manter múltiplas versões do Zig com zigup, scripts manuais e boas práticas para projetos diferentes.

• Compilar o Zig do Código-Fonte — Guia completo para compilar o compilador Zig a partir do código-fonte. Para contribuidores e usuários avançados.

• Zig em CI/CD com GitHub Actions — Configuração de pipelines de integração contínua para projetos Zig usando GitHub Actions.

Qual método de instalação escolher?

Use o download oficial quando precisar de uma versão específica. Um gerenciador de pacotes é conveniente para atualizações, mas a versão disponível pode diferir da exigida pelo projeto.

Verificando a Instalação

Independentemente do método escolhido, após a instalação, abra um terminal e execute:

zig version

A saída deve mostrar a versão que você instalou. Compare-a com a exigida pelo projeto; não há um único número de versão válido para todos os tutoriais.

Para testar o compilador no Windows, Linux ou macOS, salve este código em um arquivo chamado teste.zig usando seu editor:

const std = @import("std");

pub fn main() void {
    std.debug.print("Zig está funcionando!\n", .{});
}

No terminal, entre na pasta onde salvou o arquivo e execute:

zig run teste.zig

Se aparecer “Zig está funcionando!”, o compilador conseguiu compilar e executar o programa. std.debug.print escreve na saída de erro padrão; isso não indica uma falha neste teste.

Zig não é reconhecido no terminal: como resolver?

• Linux/macOS: execute command -v zig para identificar o executável encontrado. Se não aparecer um caminho, inclua no PATH a pasta que contém o binário zig, seguindo o guia da sua plataforma.
• Windows (PowerShell): execute Get-Command zig para localizar o compilador. Se o comando não for encontrado, confira o Path do usuário e adicione a pasta que contém zig.exe.
• Após alterar o PATH: feche e reabra o terminal. Se estiver usando um terminal integrado, pode ser necessário reiniciar o editor também.
• Versão diferente da esperada: confira o caminho retornado pelos comandos acima. Outra instalação pode estar sendo encontrada antes da desejada. Consulte gerenciar versões do Zig antes de trocar a versão usada por um projeto.

O compilador Zig e o ZLS (Zig Language Server) são ferramentas diferentes. ZLS fornece recursos ao editor, mas não substitui o compilador. Ao configurar autocomplete, confira a compatibilidade entre as versões de Zig e ZLS no projeto ZLS.

Antes de baixar: sistema, arquitetura e versão

• Sistema operacional: escolha o pacote para o sistema em que o compilador será executado. Dentro do WSL, use o pacote Linux.
• Arquitetura: x86_64 é comum em PCs Intel/AMD de 64 bits; aarch64 corresponde a ARM64, incluindo Apple Silicon. No Linux/macOS, uname -m ajuda a identificar a arquitetura.
• Versão: confira os arquivos disponíveis e os requisitos da versão na página oficial de download. Builds de desenvolvimento não são equivalentes a versões estáveis.
• Espaço e memória: reserve espaço para a pasta completa extraída, os projetos e o cache de compilação. O consumo de memória depende do que será compilado; não use um único valor como garantia para qualquer projeto.

No download manual, mantenha a distribuição extraída completa: não mova apenas o executável e descarte a pasta lib. Compilar o próprio compilador a partir do código-fonte não é necessário para começar a escrever programas Zig.

Precisa de Ajuda?

Se encontrar problemas durante a instalação, consulte:

• Nossa seção de erros comuns com soluções para os problemas mais frequentes
• O guia de como instalar Zig com instruções passo a passo simplificadas
• Nossas receitas com exemplos práticos de uso do Zig

A comunidade Zig Brasil está crescendo! Se precisar de ajuda adicional, participe dos fóruns e grupos de discussão da comunidade.

Próximos Passos

Depois de instalar o Zig com sucesso, recomendamos seguir esta ordem:

1. Configure seu editor — Escolha um dos guias de configuração acima
2. Aprenda os fundamentos — Faça o guia Zig para iniciantes: primeiros passos
3. Crie seu primeiro projeto — Siga o tutorial do primeiro projeto
4. Pratique com exemplos — Explore nossas receitas com código real
5. Configure CI/CD — Quando estiver pronto, automatize com GitHub Actions

Bons estudos e boa codificação com Zig!