Zig Academy · leksjon

Strukturere et prosjekt med flere filer

Organiser moduler på en ryddig måte.

Leksjon 2 av 413 trinn

Strukturere et prosjekt med flere filer er en gratis leksjon i Zig Academy på CoddyKit. Dette er leksjon 2 av 4. Du kan lese hele leksjonen gratis nedenfor – og deretter øve praktisk i nettleseren med en innebygd kodeeditor og en AI-veileder som er tilgjengelig døgnet rundt. Den er en del av læringsløpet i Zig Academy, og fremdriften din synkroniseres mellom nettet og CoddyKit-appen. Kurset i Zig Academy inneholder totalt 4 leksjoner.

Én fil blir overfylt

Etter hvert som programmet vokser, blir én hovedfil til en vegg av kode. Hvis du deler den opp i fokuserte filer, forblir hver del lesbar. 🗂️

main.zig er inngangen

Det kjørbare programmet starter i main.zig, der main-funksjonen ligger. Den importerer de andre filene og kobler programmet sammen.

const greet = @import("greet.zig");

Gruppér etter ansvar

Plasser beslektet kode i én fil: parsing i parser.zig og utskrift i render.zig. Hver fil har et tydelig ansvar og et begrenset grensesnitt.

En fil er en modul

Siden en fil er en struct, gir import av den en ryddig modul. De offentlige funksjonene og typene utgjør modulens offentlige API.

const parser = @import("parser.zig");
const ast = parser.parse(input);

Bruk mapper når prosjektet vokser

Gruppér filer i mapper som src/net eller src/cli. Importer dem med en relativ bane som inkluderer mappenavnet.

const http = @import("net/http.zig");

Eksporter på nytt fra ett sted

En liten rotfil kan gjøre deler fra flere filer tilgjengelige på nytt, slik at brukerne får én import som samler hele modulen.

pub const http = @import("http.zig");
pub const dns = @import("dns.zig");

Hold API-et lite

Merk bare det brukerne faktisk trenger, som pub. Alt annet forblir privat, slik at du kan omstrukturere intern implementasjon uten å bryte andre filer.

Typer følger også med

Filer eksporterer ikke bare funksjoner, men også typer. En offentlig struct eller enum i shapes.zig blir til shapes.Circle overalt der den importeres.

const shapes = @import("shapes.zig");
var c: shapes.Circle = undefined;

Vær oppmerksom på sirkler

To filer som importerer hverandre, kan danne en sirkel. Zig tolererer mange slike tilfeller, men en ryddigere struktur plasserer delte typer i en tredje fil.

Tester bor ved siden av koden

Hver fil kan inneholde egne test-blokker ved siden av koden de kontrollerer. Når du deler opp filer, holder du relaterte tester nær det de verifiserer.

test "add works" {
    try std.testing.expect(add(2, 2) == 4);
}

Gi filer forutsigbare navn

Bruk tydelige filnavn med små bokstaver som antyder innholdet, for eksempel token.zig eller config.zig. Gode navn gjør at importer nesten kan leses som prosa.

const config = @import("config.zig");

Hurtigsjekk

Husk hvordan én fil gjør funksjonene sine tilgjengelige for en annen.

Besvar den i den interaktive leksjonen

Oppsummering

Du så hvordan du kan dele kode opp i fokuserte filer og mapper, eksponere et lite pub-API og til og med eksportere på nytt gjennom én rotmodul. 🎯

Gratis å komme i gang

Lær deg Zig med en AI-veileder – gratis

Skriv og kjør ekte kode i nettleseren, få umiddelbar hjelp fra en AI-veileder som er tilgjengelig døgnet rundt, og fortsett der du slapp – på nettet eller i appen.

Kurs: 30
Leksjoner: 120

Start læringen gratis Se hele kurset

Ofte stilte spørsmål

Er leksjonen «Strukturere et prosjekt med flere filer» gratis?

Ja – hele teksten i «Strukturere et prosjekt med flere filer» er gratis å lese her på nettet. For å øve interaktivt med en innebygd kodeeditor og en AI-veileder som er tilgjengelig døgnet rundt, og for å låse opp resten av Zig Academy-kurset, kan du oppgradere til CoddyKit PRO. Kurset i Zig Academy inneholder totalt 4 leksjoner.

Hva lærer jeg i «Strukturere et prosjekt med flere filer»?

Organiser moduler på en ryddig måte. Du øver på Zig Academy med praktisk kode som du kjører direkte i nettleseren, mens en AI-veileder som er tilgjengelig døgnet rundt, svarer på spørsmålene dine mens du jobber deg gjennom leksjonen.

Trenger jeg erfaring for å begynne med Zig Academy?

Ingen tidligere erfaring er nødvendig. Zig Academy på CoddyKit er lagt opp for både nybegynnere og viderekomne, så De kan begynne her eller helt fra start og lære i Deres eget tempo. Dette er leksjon 2 av 4.

Hvor lang tid tar leksjonen «Strukturere et prosjekt med flere filer»?

De fleste CoddyKit-leksjoner tar omtrent 5–10 minutter. Hver leksjon er kort og interaktiv, slik at De gjør jevne fremskritt og kan fortsette akkurat der De slapp – både på nettet og i appen.

Kan jeg skrive og kjøre kode i denne Zig Academy-leksjonen?

Ja. Alle Zig Academy-leksjoner har en innebygd kodeeditor, slik at De kan skrive og kjøre ekte kode direkte i nettleseren og få umiddelbar tilbakemelding fra AI – uten lokal konfigurering.

Alle leksjonene i dette kurset

← Tilbake til Zig Academy