Go Academy · Lektion

Læsning af konfigurationsfiler

Indlæs YAML, JSON og TOML

Lektion 1 af 413 trin

Læsning af konfigurationsfiler er en gratis Go Academy-lektion på CoddyKit. Dette er lektion 1 af 4. Du kan læse alle 3 lektioner i dette læringsspor gratis i deres fulde længde — derefter låser CoddyKit PRO alle lektioner op samt praktiske øvelser med en indbygget kodeeditor og en AI-underviser døgnet rundt. Den er en del af læringsforløbet i Go Academy, og dine fremskridt synkroniseres på tværs af nettet og CoddyKit-appen. Go Academy-kurset indeholder 4 lektioner i alt.

Konfiguration hører ikke hjemme i koden

Hårdkodning af værdier som porte, værtsnavne og tidsgrænser i dit Go-program er skrøbeligt. Viper er den uofficielle standard til konfiguration i Go: Den læser indstillinger fra filer, miljøvariabler, flag og eksterne lagre.

I denne lektion indlæser du konfiguration fra en fil på disken.

Hvilke formater læser Viper

Viper understøtter mange formater direkte:

YAML (.yaml / .yml)
JSON (.json)
TOML (.toml)
HCL, INI og Java-egenskabsfiler

Du vælger formatet med SetConfigType, eller Viper udleder det fra filtypenavnet.

Installation og import af Viper

Føj Viper til dit modul, og importér det:

go get github.com/spf13/viper
import "github.com/spf13/viper"

Viper er en ekstern afhængighed, så kodestykker, der importerer det, kan ikke køres i denne lektionsapp. Hvor det er muligt, simulerer vi adfærden med standardbiblioteket.

import "github.com/spf13/viper"

Fortæl Viper, hvor den skal lede

Du konfigurerer filnavn, type og søgestier, før du læser:

viper.SetConfigName("config") angiver grundnavnet (uden filtypenavn)
viper.SetConfigType("yaml") angiver formatet
viper.AddConfigPath(".") føjer en mappe til søgningen

viper.SetConfigName("config")
viper.SetConfigType("yaml")
viper.AddConfigPath(".")
viper.AddConfigPath("/etc/myapp")

Læsning af filen

Kald viper.ReadInConfig() for at indlæse filen. Den returnerer en fejl, som du skal kontrollere:

En manglende fil returnerer en ConfigFileNotFoundError
En fejlformateret fil returnerer en fortolkningsfejl

if err := viper.ReadInConfig(); err != nil {
    log.Fatalf("failed to read config: %v", err)
}

Eksempel på YAML-konfiguration

Forestil dig en config.yaml som denne. Viper flader indlejrede nøgler ud ved hjælp af punktummer, så porten bliver til server.port.

server:
  port: 8080
  host: "localhost"
debug: true

Hentning af typede værdier

Viper har typede hentefunktioner, så du undgår manuelle konverteringer:

viper.GetInt("server.port")
viper.GetString("server.host")
viper.GetBool("debug")

port := viper.GetInt("server.port")
host := viper.GetString("server.host")
debug := viper.GetBool("debug")
fmt.Println(host, port, debug)

JSON fungerer på samme måde

Hvis du skifter til JSON, ændrer du kun filens indhold og konfigurationstypen. De samme nøglestier og hentefunktioner gælder. Denne formatuafhængighed er grunden til, at Viper er populær: Din kode er ligeglad med, hvilket format driftsteamet valgte.

{
  "server": { "port": 8080, "host": "localhost" },
  "debug": true
}

TOML understøttes også

TOML er almindeligt i Go-økosystemet, hvor mange kommandolinjeværktøjer bruger det. De samme indlejrede nøgler svarer til punktseparerede stier.

[server]
port = 8080
host = "localhost"

debug = true

Fortolkning af JSON med standardbiblioteket

For at se idéen fungere i praksis viser dette eksempel, hvordan almindelig Go fortolker JSON-konfiguration uden Viper og kun bruger encoding/json til at læse ind i en opslagstabel. Viper bruger selv en generisk nøgle-værdi-struktur internt.

package main

import (
    "encoding/json"
    "fmt"
)

func main() {
    raw := "{\"port\":8080,\"host\":\"localhost\"}"
    var c map[string]any
    if err := json.Unmarshal([]byte(raw), &c); err != nil {
        panic(err)
    }
    fmt.Printf("%v:%v\n", c["host"], c["port"])
}

Kørbart eksempel: Læsning til en opslagstabel

Dette selvstændige program fortolker JSON-konfiguration til en generisk opslagstabel og udskriver værdier, hvilket afspejler, hvad Viper gør internt med JSON.

package main

import (
    "encoding/json"
    "fmt"
)

func main() {
    raw := "{\"port\":8080,\"host\":\"localhost\"}"
    var m map[string]any
    json.Unmarshal([]byte(raw), &m)
    fmt.Println("host:", m["host"])
    fmt.Println("port:", m["port"])
}

Hurtigt tjek

Test din forståelse af, hvordan Viper læser konfigurationsfiler.

Besvar den i den interaktive lektion

Opsamling

Du har lært, hvordan Viper læser konfigurationsfiler:

Det understøtter YAML, JSON og TOML uden særlige tilpasninger
Konfigurér med SetConfigName, SetConfigType og AddConfigPath
ReadInConfig() indlæser filen og returnerer en fejl
Typede hentefunktioner som GetInt og GetString læser værdier via punktseparerede nøgler

Næste trin: Tilsidesættelse af konfiguration med miljøvariabler.

Gratis at komme i gang

Lær Go med en AI-underviser — gratis

Skriv og kør rigtig kode i din browser, få øjeblikkelig hjælp fra en AI-underviser døgnet rundt, og fortsæt, hvor du slap, på web eller i appen.

Kurser: 51
Lektioner: 203

Start gratis Se hele kurset

Ofte stillede spørgsmål

Er lektionen “Læsning af konfigurationsfiler” gratis?

Ja — alle 3 lektioner i læringssporet Go Academy, inklusive “Læsning af konfigurationsfiler”, kan læses gratis i deres fulde længde her på webstedet. Derefter låser CoddyKit PRO alle lektioner op samt interaktive øvelser med en indbygget kodeeditor og en AI-underviser døgnet rundt. Go Academy-kurset indeholder 4 lektioner i alt.

Hvad lærer jeg i “Læsning af konfigurationsfiler”?

Indlæs YAML, JSON og TOML Du øver dig i Go Academy med praktisk kode, som du kører direkte i browseren, og en AI-vejleder døgnet rundt besvarer dine spørgsmål, mens du arbejder dig gennem lektionen.

Skal jeg have erfaring for at begynde på Go Academy?

Der kræves ingen tidligere erfaring. Go Academy på CoddyKit er tilrettelagt for både begyndere og øvede, så du kan starte her eller fra begyndelsen og lære i dit eget tempo. Dette er lektion 1 af 4.

Hvor lang tid tager lektionen “Læsning af konfigurationsfiler”?

De fleste CoddyKit-lektioner tager cirka 5–10 minutter. Hver lektion er kort og interaktiv, så du gør løbende fremskridt og kan fortsætte, hvor du slap – på både web og app.

Kan jeg skrive og køre kode i denne Go Academy-lektion?

Ja. Alle Go Academy-lektioner har en indbygget kodeeditor, så du kan skrive og køre rigtig kode direkte i din browser og få øjeblikkelig feedback fra AI – uden lokal opsætning.

Alle lektioner i dette kursus

← Tilbage til Go Academy