Como Instalar Zig no Windows

Este guia cobre a instalação do compilador Zig no Windows 10 e Windows 11. Apresentamos quatro métodos: Scoop (recomendado), Chocolatey, WinGet e download manual. Cada método inclui configuração completa do PATH e verificação da instalação.

Para outras plataformas, consulte o guia completo de instalação. Se você prefere usar um ambiente Linux no Windows, veja o guia de Zig no WSL.

Método 1: Scoop (Recomendado)

O Scoop é um gerenciador de pacotes para Windows que instala aplicativos na linha de comando, sem necessidade de permissões de administrador.

Pré-requisito: Instalar o Scoop

Abra o PowerShell e execute:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression

Instalar o Zig

scoop install zig

Verificar a Instalação

zig version

Atualizar o Zig

scoop update zig

Desinstalar

scoop uninstall zig

Vantagens do Scoop

• Não requer permissões de administrador
• Instala no diretório do usuário (~/scoop/)
• Configura o PATH automaticamente
• Atualização e desinstalação limpas

Método 2: Chocolatey

O Chocolatey é outro gerenciador de pacotes popular no Windows, amplamente usado em ambientes corporativos.

Pré-requisito: Instalar o Chocolatey

Abra o PowerShell como Administrador e execute:

Set-ExecutionPolicy Bypass -Scope Process -Force
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072
iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

Instalar o Zig

choco install zig

Verificar

zig version

Atualizar

choco upgrade zig

Desinstalar

choco uninstall zig

Método 3: WinGet

O WinGet é o gerenciador de pacotes oficial da Microsoft, incluído no Windows 11 e disponível para Windows 10 via Microsoft Store.

Instalar o Zig

winget install zig.zig

Verificar

Feche e reabra o terminal, depois:

zig version

Atualizar

winget upgrade zig.zig

Desinstalar

winget uninstall zig.zig

Método 4: Download Manual

O download manual é útil quando você precisa de controle total sobre a instalação ou quando está em um ambiente sem gerenciadores de pacotes.

Passo 1: Baixar o Zig

Acesse ziglang.org/download e baixe a versão para Windows x86_64. Ou use o PowerShell:

Invoke-WebRequest -Uri "https://ziglang.org/download/0.14.0/zig-windows-x86_64-0.14.0.zip" -OutFile "zig.zip"

Passo 2: Extrair o Arquivo

Expand-Archive -Path "zig.zip" -DestinationPath "C:\zig"

Isso vai criar o diretório C:\zig\zig-windows-x86_64-0.14.0\.

Passo 3: Configurar o PATH

Via PowerShell (Recomendado)

Para adicionar permanentemente ao PATH do usuário:

$zigPath = "C:\zig\zig-windows-x86_64-0.14.0"
$currentPath = [Environment]::GetEnvironmentVariable("Path", "User")
if ($currentPath -notlike "*$zigPath*") {
    [Environment]::SetEnvironmentVariable("Path", "$currentPath;$zigPath", "User")
    Write-Host "Zig adicionado ao PATH com sucesso!"
} else {
    Write-Host "Zig já está no PATH."
}

Importante: Feche e reabra o PowerShell ou o Prompt de Comando para que as alterações no PATH tenham efeito.

Via Interface Gráfica

1. Pressione Win + R, digite sysdm.cpl e pressione Enter
2. Na aba Avançado, clique em Variáveis de Ambiente
3. Em Variáveis do usuário, selecione Path e clique em Editar
4. Clique em Novo e adicione C:\zig\zig-windows-x86_64-0.14.0
5. Clique em OK em todas as janelas

Passo 4: Verificar

Abra um novo terminal e execute:

zig version

Passo 5: Testar

Crie um arquivo teste.zig:

const std = @import("std");

pub fn main() !void {
    const stdout = std.io.getStdOut().writer();
    try stdout.print("Zig funcionando no Windows!\n", .{});

    // Listar argumentos da linha de comando
    var args = std.process.args();
    _ = args.skip(); // Pular o nome do programa
    try stdout.print("Programa executado com sucesso.\n", .{});
}

zig run teste.zig

Usando o Zig no Prompt de Comando (cmd)

Todos os exemplos acima funcionam tanto no PowerShell quanto no Prompt de Comando tradicional. Para verificar no cmd:

zig version
zig run teste.zig

Usando o Zig como Compilador C no Windows

O Zig inclui um compilador C completo baseado no Clang, o que é extremamente útil no Windows, onde configurar um compilador C pode ser complicado (Visual Studio, MinGW, etc.).

Compilar código C sem instalar Visual Studio

# Criar um arquivo C de teste
@"
#include <stdio.h>
int main() {
    printf("Hello do compilador C do Zig!\n");
    return 0;
}
"@ | Out-File -Encoding utf8 hello.c

# Compilar com o Zig
zig cc -o hello.exe hello.c

# Executar
.\hello.exe

Compilar com a API do Windows

const std = @import("std");
const windows = std.os.windows;

pub fn main() !void {
    const stdout = std.io.getStdOut().writer();
    try stdout.print("Rodando nativamente no Windows!\n", .{});
}

Cross-compilar do Windows para Linux

zig build-exe --target=x86_64-linux-gnu main.zig

Windows Terminal e Configuração do Shell

Windows Terminal (Recomendado)

O Windows Terminal é o emulador de terminal moderno da Microsoft. Se ainda não o tem:

winget install Microsoft.WindowsTerminal

Configuração de Perfil do PowerShell

Adicione aliases úteis ao seu perfil do PowerShell. Primeiro, verifique se o arquivo de perfil existe:

if (!(Test-Path -Path $PROFILE)) {
    New-Item -ItemType File -Path $PROFILE -Force
}
notepad $PROFILE

Adicione ao arquivo de perfil:

# Aliases para Zig
function zb { zig build $args }
function zr { zig run $args }
function zt { zig test $args }

# Verificar versão do Zig no início da sessão
Write-Host "Zig $(zig version) disponível" -ForegroundColor Green

Integração com Visual Studio Build Tools

Para projetos que precisam linkar com bibliotecas do Windows SDK, você pode precisar do Visual Studio Build Tools:

winget install Microsoft.VisualStudio.2022.BuildTools

O Zig detecta automaticamente o Visual Studio Build Tools e pode usar os headers e bibliotecas do Windows SDK.

Se o Zig não encontrar o SDK automaticamente, você pode especificar o caminho:

# Encontrar o SDK do Windows
dir "C:\Program Files (x86)\Windows Kits\10\Include"

Problemas Comuns no Windows

“zig is not recognized as an internal or external command”

Isso significa que o PATH não está configurado corretamente. Verifique:

$env:Path -split ';' | Where-Object { $_ -like '*zig*' }

Se não retornar nada, adicione o caminho do Zig ao PATH conforme explicado no Método 4.

Windows Defender bloqueando o Zig

O Windows Defender pode inicialmente bloquear o Zig. Se isso acontecer:

1. Abra Segurança do Windows
2. Vá em Proteção contra vírus e ameaças
3. Clique em Histórico de proteção
4. Encontre o bloqueio do Zig e clique em Permitir

Ou adicione uma exclusão:

# Executar como Administrador
Add-MpPreference -ExclusionPath "C:\zig"

Erro de codificação de caracteres

Se você vir caracteres estranhos na saída do Zig, configure o terminal para UTF-8:

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
chcp 65001

Adicione isso ao seu perfil do PowerShell para que funcione automaticamente.

Antivírus de terceiros

Alguns antivírus podem marcar o Zig como falso positivo. Adicione o diretório do Zig à lista de exclusões do seu antivírus.

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

Próximos Passos

Com o Zig instalado no Windows:

1. Configure seu editor — O VS Code é a escolha mais popular no Windows
2. Crie seu primeiro projeto — Primeiro projeto Zig
3. Considere o WSL — Para uma experiência Linux no Windows, veja Zig no WSL
4. Aprenda a linguagem — Introdução ao Zig
5. Veja exemplos — Receitas

Se você trabalha com CI/CD, confira nosso guia de Zig com GitHub Actions para automatizar builds e testes.