Instalar Zig consiste en preparar el compilador, el PATH y el editor para escribir y ejecutar código. Ahora que ya sabemos por qué Zig es una herramienta tan interesante, llega el momento de mancharse las manos.
A diferencia de otros entornos de desarrollo que requieren instaladores pesados o muchas dependencias, Zig se distribuye en una carpeta autocontenida.
Dentro encontramos el ejecutable del compilador y los archivos de su biblioteca. No hace falta ejecutar un instalador: basta con descomprimir la distribución y añadirla al PATH.
En esta entrada vamos a preparar la máquina para desarrollar en Zig y a configurar VS Code con ZLS (Zig Language Server). Se puede programar sin ZLS, claro, pero el autocompletado y los diagnósticos nos ahorrarán bastante trabajo.
Zig aún no ha llegado a la versión 1.0 (sigue en versiones 0.x). A fecha de esta revisión, la última versión estable es Zig 0.16.0. Para seguir el curso, mejor usar una versión estable etiquetada; los builds de desarrollo son útiles para probar novedades, pero pueden cambiar cosas de un día para otro.
Descarga e instalación del compilador
Tenemos dos caminos para instalar Zig: descargar la distribución oficial o usar un gestor de paquetes.
Con un gestor de paquetes
Si ya usas un gestor de paquetes, esta suele ser la forma más cómoda de mantener Zig actualizado.
En Windows (con Winget o Chocolatey):
winget install -e --id zig.zig
# O si usas Chocolatey
choco install zigEn macOS (con Homebrew):
brew install zigEn Linux (con Snap):
snap install zig --classicCon la distribución oficial
Esta opción resulta útil para tener múltiples versiones de Zig o controlar exactamente cuál usa cada proyecto.
- Ve a la página oficial de descargas de Zig.
- Descarga el archivo comprimido (
.zipo.tar.xz) correspondiente a tu sistema operativo y arquitectura. - Descomprime la carpeta en una ubicación estable (por ejemplo,
C:\zig\en Windows o~/zig/en Linux y macOS). - Añade esa carpeta al
PATHdel sistema.
¿Por qué el PATH?
El PATH es una variable de entorno que le dice a tu terminal “dónde buscar” cuando escribes un comando. Al añadir la carpeta de Zig, podrás escribir zig en cualquier consola y que funcione.
Verificando la instalación
Sea cual sea el método elegido, abre una terminal y escribe:
zig versionSi devuelve 0.16.0 (o la versión estable que hayas instalado), ya tienes el compilador listo.
El entorno de desarrollo: VS Code y ZLS
Tener el compilador es solo la mitad de la batalla. Zig es un lenguaje moderno y, como tal, se beneficia enormemente de un buen soporte en el editor.
Aunque puedes usar Vim, Emacs o cualquier otro editor, nosotros vamos a centrarnos en Visual Studio Code, que tiene una integración muy cómoda.
Instalar la extensión oficial
En VS Code, vamos al marketplace de extensiones y buscamos “Zig”.
Instala la extensión oficial Zig Language, publicada por ziglang y cuyo identificador es ziglang.vscode-zig. Incluye resaltado de sintaxis, formateo e integración con ZLS.
ZLS: el servidor de lenguaje de Zig
ZLS (Zig Language Server) es una herramienta que se ejecuta en segundo plano y analiza nuestro código en tiempo real. Nos proporciona:
- Autocompletado inteligente.
- Ir a la definición (Ctrl + Click).
- Detección de errores mientras escribimos (sin necesidad de compilar).
- Formateo automático del código.
La extensión de VS Code puede instalar y actualizar Zig y ZLS automáticamente.
- Abre cualquier archivo
.zigen VS Code. - Si aparece el aviso de instalación de ZLS, pulsa Install.
- Comprueba en la configuración de la extensión qué versiones de Zig y ZLS está usando.
Si prefieres hacerlo manualmente:
- Descarga una versión de ZLS compatible desde su repositorio oficial.
- En la configuración de la extensión, indica las rutas de los ejecutables de Zig y ZLS.
Configura VS Code para que formatee al guardar. En tu settings.json:
"[zig]": { "editor.formatOnSave": true }El formato aplicado por ZLS coincide con zig fmt, así que el código conservará el estilo estándar.
Nuestro primer «Hola mundo»
Vamos a comprobar que todo el engranaje funciona. Crea una carpeta nueva para el proyecto y dentro un archivo llamado main.zig.
Escribe el siguiente código:
const std = @import("std");
pub fn main() void {
std.debug.print("¡Hola mundo desde Zig!\n", .{});
}No pasa nada si la sintaxis todavía resulta nueva: la veremos más adelante. Lo importante aquí es comprobar si ZLS autocompleta std.debug mientras escribes. Si lo hace, el entorno está bien configurado.
Ejecutando el código
En Zig tenemos una herramienta maravillosa para el desarrollo: zig run.
Este comando compila el programa en una carpeta temporal y lo ejecuta inmediatamente, todo en un solo paso. Es perfecto para probar cosas rápido.
Abre la terminal en VS Code y ejecuta:
zig run main.zigDeberías ver:
¡Hola mundo desde Zig!
Compilando un ejecutable real
Para generar un ejecutable (un .exe en Windows o un binario en Linux y macOS), usamos:
zig build-exe main.zigEsto generará un archivo main.exe o main en la carpeta actual.
Por defecto, Zig compila en modo “Debug” (más lento, pero con comprobaciones de seguridad). Para sacar el máximo rendimiento usaremos zig build-exe main.zig -O ReleaseFast.