---
title: "Como Instalar Zig no Windows — Scoop, Chocolatey, WinGet e Manual"
url: "https://ziglang.com.br/instalacao/como-instalar-zig-no-windows-scoop-chocolatey-winget-e-manual/"
markdown_url: "https://ziglang.com.br/instalacao/como-instalar-zig-no-windows-scoop-chocolatey-winget-e-manual.MD"
description: "Guia completo para instalar o Zig no Windows 10/11. Métodos com Scoop, Chocolatey, WinGet e instalação manual com configuração do PATH."
date: "2026-02-21"
author: "Zig Brasil"
---

# Como Instalar Zig no Windows — Scoop, Chocolatey, WinGet e Manual

Guia completo para instalar o Zig no Windows 10/11. Métodos com Scoop, Chocolatey, WinGet e instalação manual com configuração do PATH.


# 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](/instalacao/). Se você prefere usar um ambiente Linux no Windows, veja o guia de [Zig no WSL](/instalacao/instalar-zig-wsl/).

---

## Método 1: Scoop (Recomendado)

O [Scoop](https://scoop.sh/) é 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:

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

### Instalar o Zig

```powershell
scoop install zig
```

### Verificar a Instalação

```powershell
zig version
```

### Atualizar o Zig

```powershell
scoop update zig
```

### Desinstalar

```powershell
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](https://chocolatey.org/) é outro gerenciador de pacotes popular no Windows, amplamente usado em ambientes corporativos.

### Pré-requisito: Instalar o Chocolatey

Abra o **PowerShell como Administrador** e execute:

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

```powershell
choco install zig
```

### Verificar

```powershell
zig version
```

### Atualizar

```powershell
choco upgrade zig
```

### Desinstalar

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

```powershell
winget install zig.zig
```

### Verificar

Feche e reabra o terminal, depois:

```powershell
zig version
```

### Atualizar

```powershell
winget upgrade zig.zig
```

### Desinstalar

```powershell
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](https://ziglang.org/download/) e baixe a versão para Windows x86_64. Ou use o PowerShell:

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

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

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

```powershell
zig version
```

### Passo 5: Testar

Crie um arquivo `teste.zig`:

```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", .{});
}
```

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

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

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

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

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

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

Adicione ao arquivo de perfil:

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

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

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

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

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

```powershell
[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](/erros/).

---

## Próximos Passos

Com o Zig instalado no Windows:

1. **Configure seu editor** — O [VS Code](/instalacao/configurar-vscode-zig/) é a escolha mais popular no Windows
2. **Crie seu primeiro projeto** — [Primeiro projeto Zig](/instalacao/zig-primeiro-projeto/)
3. **Considere o WSL** — Para uma experiência Linux no Windows, veja [Zig no WSL](/instalacao/instalar-zig-wsl/)
4. **Aprenda a linguagem** — [Introdução ao Zig](/tutoriais/introducao-ao-zig/)
5. **Veja exemplos** — [Receitas](/receitas/)

Se você trabalha com CI/CD, confira nosso guia de [Zig com GitHub Actions](/instalacao/zig-ci-github-actions/) para automatizar builds e testes.