Zig Academy · Leçon

Anatomie d'un fichier build.zig

La fonction de compilation et le Builder.

Leçon 1 sur 413 étapes

Anatomie d'un fichier build.zig est une leçon Zig Academy gratuite sur CoddyKit. Ceci est la leçon 1 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Zig Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Zig Academy comprend 4 leçons au total.

Un script de compilation en Zig

La compilation de votre projet n’est pas un fichier de configuration écrit dans un autre langage. Il s’agit d’un véritable programme Zig nommé build.zig, que vous pouvez lire et déboguer. 🏗️

Tout commence par build

Chaque build.zig expose un point d’entrée : une fonction publique build. Zig l’appelle pour découvrir ce que votre projet doit produire.

pub fn build(b: *std.Build) void {
    _ = b;
}

L’objet de construction

Ce paramètre unique b est un *std.Build. C’est le constructeur : chaque artefact et chaque étape que vous souhaitez créer passent par lui.

b: *std.Build

Importer la bibliothèque standard

Comme tout fichier Zig, build.zig importe std au début afin que vous puissiez accéder à std.Build et à ses types auxiliaires.

const std = @import("std");

Décrire plutôt qu’exécuter

La fonction de compilation ne compile rien elle-même. Elle décrit un graphe d’étapes et d’artefacts que Zig exécute ensuite.

Choisir la cible

Utilisez standardTargetOptions pour laisser la ligne de commande choisir le système d’exploitation et le CPU ciblés, en utilisant par défaut votre propre machine.

const target = b.standardTargetOptions(.{});

Choisir le mode d’optimisation

Associez-la à standardOptimizeOption afin que les utilisateurs transmettent Debug ou ReleaseFast sur la ligne de commande au lieu de modifier le fichier.

const optimize = b.standardOptimizeOption(.{});

Ajouter un artefact

Dans build, vous créez les éléments à compiler, comme un exécutable. Chaque artefact ajouté devient un nœud du graphe de compilation.

L’exécuter avec zig build

Depuis la racine du projet, la commande zig build trouve build.zig, appelle votre fonction build et exécute le graphe obtenu.

zig build

Ce n’est que du code

Comme build.zig est du Zig ordinaire, vous pouvez utiliser des variables, des conditions et des boucles pour façonner la compilation selon vos besoins.

Un fichier pour tout le projet

Ce fichier unique est la référence de tout votre projet : les cibles, les modes, les artefacts et les étapes se trouvent tous dans build.zig. ✅

Vérification rapide

Rappelez-vous ce que Zig recherche lorsque vous lancez la compilation.

Récapitulatif

Vous avez vu que build.zig est un programme Zig doté d’une fonction build publique qui accepte un *std.Build, dans laquelle vous définissez la cible, l’optimisation et les artefacts. 🎯

Gratuit pour commencer

Apprends Zig avec un tuteur IA — gratuit

Écris et exécute du vrai code dans ton navigateur, obtiens de l'aide instantanée d'un tuteur IA disponible 24h/24, et reprends là où tu t'es arrêté sur le web ou dans l'app.

Cours
30
Leçons
120

Questions Fréquemment Posées

La leçon « Anatomie d'un fichier build.zig » est-elle gratuite ?

Oui — le texte complet de « Anatomie d'un fichier build.zig » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Zig Academy, passe à CoddyKit PRO. Le cours Zig Academy comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Anatomie d'un fichier build.zig » ?

La fonction de compilation et le Builder. Tu pratiques Zig Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer Zig Academy ?

Aucune expérience préalable n'est requise. Zig Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 1 sur 4.

Combien de temps prend la leçon « Anatomie d'un fichier build.zig » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon Zig Academy ?

Oui. Chaque leçon Zig Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

  1. Anatomie d'un fichier build.zig
  2. Déclarer des exécutables et des bibliothèques
  3. Étapes de compilation et zig build run
  4. Options et indicateurs de compilation
← Retour à Zig Academy