Hvordan organiserer pakker og moduler Go-kode?

Question

Accepted Answer

Go organiserer kode med **pakker** (samlinger af kildefiler i en mappe) og **moduler** (samlinger af pakker med versionsstyret afhængigheder). Sammen strukturerer de projekter og administrerer afhængigheder.

## Pakker — en mappe med relateret kode

```go
// every .go file starts by declaring its package
package main         // "main" is special — produces an executable

// or a library package (named after its directory, conventionally)
package mathutil

func Add(a, b int) int { return a + b }   // Exported (capitalized) — usable outside
func helper() {}                           // unexported (lowercase) — package-private
```

Alle filer i én mappe tilhører én pakke. **Kapitalisering styrer synlighed**: kapitaliserede navne eksporteres (offentlig på tværs af pakker), små bogstaver er private for pakken.

## Import og brug af pakker

```go
import (
    "fmt"                          // standard library
    "strings"
    "github.com/user/repo/mathutil" // a third-party or local module package
)

fmt.Println(strings.ToUpper("hi"))
mathutil.Add(2, 3)                  // use Exported names via package.Name
```

## Moduler — versionsstyret afhængighedsstyring

```bash
go mod init github.com/user/myapp   # create a module → makes go.mod
go get github.com/gin-gonic/gin     # add a dependency (records it in go.mod)
go mod tidy                          # add missing & remove unused dependencies
go build                             # build using the module's dependencies
```

```text
go.mod  — declares the module path, Go version, and direct dependencies (+ versions)
go.sum  — cryptographic checksums of dependencies (integrity/security)
```

En **modul** (introduceret i Go 1.11) er enheden for afhængighedsstyring — `go.mod` viser nøjagtige versioner af afhængigheder, hvilket gør builds reproducerbare. `go.sum` verificerer afhængighedsintegritet.

## init-funktionen og main

```go
package main

func init() {    // runs automatically when the package loads (before main)
    // setup
}
func main() {    // entry point of an executable (package main only)
}
```

## Projektstrukturkonventioner

```text
myapp/
  go.mod
  main.go              package main
  internal/            packages here are PRIVATE to this module (can't be imported externally)
  pkg/ or other dirs/  reusable packages
```

Mappen `internal/` er speciel — dens pakker kan kun importeres inden for samme modul, hvilket håndhæver indkapsling på modulniveauet.

## Hvorfor det betyder noget

Pakker og moduler er, hvordan Go-projekter struktureres, og hvordan afhængigheder administreres — væsentligt for ethvert rigtigt projekt.

At forstå pakker (en mappe med filer, synlighed baseret på kapitalisering eksporteret/ueksporteret, den specielle `main`-pakke) er grundlæggende for at organisere kode og kontrollere dens offentlige API.

Moduler (`go mod`, `go.mod`/`go.sum`) giver reproducerbar, versionsstyret, integritet-kontrolleret afhængighedsstyring — den moderne standard, der erstattede den gamle GOPATH-tilgang.

At kende importsystemet, `internal/`-konventionen for modulprivat kode og værktøjerne (`go mod init/tidy`, `go get`) er nødvendigt for at bygge, dele og vedligeholde Go-projekter, og afspejler praktisk flydende færdighed med Go-økosystemet.