Go Academy · leksjon

Interne pakker og arbeidsområder

internal/, replace-direktiver og go work

Leksjon 4 av 412 trinn

Interne pakker og arbeidsområder er en gratis leksjon i Go Academy på CoddyKit. Dette er leksjon 4 av 4. Du kan lese valgfritt 3 leksjoner fra denne læringsstien gratis i sin helhet – deretter låser CoddyKit PRO opp alle leksjoner, samt praktisk øving med en innebygd kodeeditor og en AI-veileder som er tilgjengelig døgnet rundt. Den er en del av læringsløpet i Go Academy, og fremdriften din synkroniseres mellom nettet og CoddyKit-appen. Kurset i Go Academy inneholder totalt 4 leksjoner.

internal/-katalogen

Pakker i en internal/-katalog kan bare importeres av kode i det overordnede katalogtreet. Dette håndhever innkapsling av pakker:

// Project structure:
// myapp/
//   main.go
//   internal/
//     auth/auth.go      <- can only be imported by myapp/
//     db/db.go          <- can only be imported by myapp/
//   api/
//     handlers.go       <- can import myapp/internal/auth

// External package CANNOT do:
// import "myapp/internal/auth"  <- compile error

Bruke internal/-pakker

Kode i samme modul (over internal/-katalogen) kan fritt importere interne pakker:

// myapp/api/handlers.go
package api

import (
    "myapp/internal/auth"
    "myapp/internal/db"
)

func GetUser(id int) (*db.User, error) {
    if !auth.IsValid() {
        return nil, auth.ErrUnauthorized
    }
    return db.FindUser(id)
}

Hvorfor bruke internal/?

Fordeler ved internal/-konvensjonen:

Hindrer andre moduler i å bli avhengige av implementasjonsdetaljer
Lar deg omstrukturere fritt uten å bryte eksterne kallere
Gir et tydelig signal: Dette er ikke en del av det offentlige API-et
Standardverktøyene i Go håndhever begrensningen ved kompilering

Go-arbeidsområder – go work

Go 1.18 introduserte arbeidsområder for å arbeide med flere lokale moduler samtidig, uten replace-direktiver:

# Create a workspace in parent directory:
go work init ./myapp ./mylib

# Creates go.work:
# go 1.21
# use (
#     ./myapp
#     ./mylib
# )

# Now myapp can import mylib without replace directives

go work sync

Synkroniser arbeidsområdeavhengigheter med go work sync:

# go.work file:
go 1.21

use (
    ./api
    ./worker
    ./shared
)

# Sync all module dependencies:
go work sync

# Build across all workspace modules:
go build ./...

# Test across all workspace modules:
go test ./...

Arbeidsområde kontra replace-direktivet

Sammenligning av to tilnærminger til lokal utvikling med flere moduler:

// BEFORE workspaces (cumbersome):
// go.mod in myapp:
// replace github.com/me/mylib => ../mylib
// Must remove before publishing!

// WITH workspaces (cleaner):
// go.work at root:
// use (./myapp ./mylib)
// go.mod files stay clean — go.work is gitignored

Bruksområder for arbeidsområder

Når du bør bruke Go-arbeidsområder:

Utvikle et bibliotek og en bruker av biblioteket samtidig
Monorepo med flere moduler som refererer til hverandre
Teste endringer i en delt modul før publisering
Arbeide med en forgrening av en avhengighet samtidig som du arbeider med appen

go work add og go work use

Administrer oppføringer i arbeidsområdet med underkommandoer til go work:

# Add a module to the workspace
go work use ./newservice

# Remove a module from workspace
go work use -r ./oldservice

# Edit go.work directly (opens $EDITOR):
go work edit

# go.work should usually be gitignored:
echo "go.work" >> .gitignore
echo "go.work.sum" >> .gitignore

internal/ og arbeidsområder sammen

Interne pakker og arbeidsområder kombineres naturlig i monorepoer:

// Monorepo structure:
// services/
//   go.work
//   auth-service/
//     internal/tokens/   <- private to auth-service
//   order-service/
//     internal/pricing/  <- private to order-service
//   shared/
//     models/            <- shared across services

// go.work:
// use (./auth-service ./order-service ./shared)

Beste praksis for organisering av pakker

Anbefalinger for oppbygning av Go-prosjekter:

Flat pakkestruktur for små prosjekter – unngå organisering for tidlig
Bruk internal/ for implementasjonsdetaljer som ikke er ment for ekstern bruk
Plasser CLI-hovedpakker under cmd/appname/
Bruk arbeidsområder for repositorier med flere moduler, men legg go.work i gitignore
Unngå dyp nøsting – maksimalt 3–4 pakkenivåer

Kort kontroll

Hvem kan importere en pakke i en internal/-katalog?

Besvar den i den interaktive leksjonen

Oppsummering: Interne pakker og arbeidsområder

Sammendrag:

internal/ begrenser importer til det overordnede katalogtreet – kompilatoren håndhever dette
Bruk internal/ for å skjule implementasjonsdetaljer for eksterne brukere
go work init oppretter et arbeidsområde for lokal utvikling med flere moduler
Arbeidsområder erstatter replace-direktiver under lokal utvikling
Legg go.work og go.work.sum i gitignore

Gratis å komme i gang

Lær deg Go 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: 51
Leksjoner: 203

Start læringen gratis Se hele kurset

Ofte stilte spørsmål

Er leksjonen «Interne pakker og arbeidsområder» gratis?

Ja – du kan lese valgfritt 3 av leksjonene i læringsstien Go Academy, inkludert «Interne pakker og arbeidsområder», gratis i sin helhet her på nettet. Deretter låser CoddyKit PRO opp alle leksjoner, samt interaktiv øving med en innebygd kodeeditor og en AI-veileder som er tilgjengelig døgnet rundt. Kurset i Go Academy inneholder totalt 4 leksjoner.

Hva lærer jeg i «Interne pakker og arbeidsområder»?

internal/, replace-direktiver og go work Du øver på Go 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 Go Academy?

Ingen tidligere erfaring er nødvendig. Go 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 4 av 4.

Hvor lang tid tar leksjonen «Interne pakker og arbeidsområder»?

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 Go Academy-leksjonen?

Ja. Alle Go 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 Go Academy