Go Academy · Lekcja

Odczytywanie plików konfiguracyjnych

Wczytuj YAML, JSON i TOML

Lekcja 1 z 413 kroki

Odczytywanie plików konfiguracyjnych to bezpłatna lekcja Go Academy na CoddyKit. To lekcja 1 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Go Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Go Academy zawiera 4 lekcji w sumie.

Konfiguracja poza kodem

Wpisywanie na stałe wartości takich jak porty, nazwy hostów i limity czasu do programu w Go jest rozwiązaniem zawodnym. Viper to de facto standardowa biblioteka konfiguracyjna dla Go: odczytuje ustawienia z plików, zmiennych środowiskowych, flag i zdalnych magazynów.

W tej lekcji wczytają Państwo konfigurację z pliku na dysku.

Jakie formaty odczytuje Viper

Viper natywnie obsługuje wiele formatów:

YAML (.yaml / .yml)
JSON (.json)
TOML (.toml)
pliki HCL, INI i Java properties

Format wybiera się za pomocą SetConfigType, ale Viper może też wywnioskować go z rozszerzenia pliku.

Instalowanie i importowanie Viper

Dodaj Viper do modułu i zaimportuj go:

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

Ponieważ Viper jest zewnętrzną zależnością, fragmenty importujące go nie mogą być uruchamiane w odtwarzaczu tej lekcji. Tam, gdzie to możliwe, symulujemy jego działanie za pomocą biblioteki standardowej.

import "github.com/spf13/viper"

Wskazywanie Viperowi miejsc wyszukiwania

Przed odczytem należy skonfigurować nazwę pliku, typ i ścieżki wyszukiwania:

viper.SetConfigName("config") ustawia nazwę bazową, bez rozszerzenia
viper.SetConfigType("yaml") ustawia format
viper.AddConfigPath(".") dodaje katalog do przeszukania

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

Odczytywanie pliku

Wywołaj viper.ReadInConfig(), aby wczytać plik. Funkcja zwraca błąd, który należy sprawdzić:

Brak pliku powoduje zwrócenie błędu ConfigFileNotFoundError
Niepoprawnie sformatowany plik powoduje zwrócenie błędu parsowania

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

Przykładowa konfiguracja YAML

Wyobraź sobie plik config.yaml o takiej zawartości. Viper spłaszcza zagnieżdżone klucze, używając kropek, dlatego port staje się kluczem server.port.

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

Pobieranie wartości określonego typu

Viper udostępnia gettery zwracające wartości określonych typów, dzięki czemu można uniknąć ręcznych konwersji:

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 działa tak samo

Przejście na JSON wymaga zmiany tylko zawartości pliku i typu konfiguracji. Te same ścieżki kluczy i gettery nadal działają. Ta przenośność jest jednym z powodów popularności Viper: kod nie musi wiedzieć, który format wybrał zespół operacyjny.

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

TOML również jest obsługiwany

TOML jest często używany w ekosystemie Go, a wiele narzędzi CLI korzysta z tego formatu. Te same zagnieżdżone klucze są mapowane na ścieżki rozdzielane kropkami.

[server]
port = 8080
host = "localhost"

debug = true

Parsowanie JSON za pomocą biblioteki standardowej

Aby zobaczyć, jak ta koncepcja działa w praktyce, poniżej przedstawiono zwykłe parsowanie konfiguracji JSON w Go bez Viper, wyłącznie za pomocą encoding/json i mapy. Sam Viper również korzysta wewnętrznie z ogólnej mapy.

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"])
}

Wykonywalny przykład: odczyt do mapy

Ten samodzielny program parsuje konfigurację JSON do ogólnej mapy i wypisuje wartości, odzwierciedlając wewnętrzne działanie Viper dla formatu 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"])
}

Szybkie sprawdzenie

Sprawdź swoją wiedzę o odczytywaniu plików konfiguracyjnych za pomocą Viper.

Odpowiedz w interaktywnej lekcji

Podsumowanie

Dowiedzieli się Państwo, jak Viper odczytuje pliki konfiguracyjne:

Przejrzyście obsługuje YAML, JSON i TOML
Konfigurację ustawia się za pomocą SetConfigName, SetConfigType i AddConfigPath
ReadInConfig() wczytuje plik i zwraca błąd
Gettery określonych typów, takie jak GetInt i GetString, odczytują wartości na podstawie klucza rozdzielanego kropkami

Dalej: zastępowanie konfiguracji zmiennymi środowiskowymi.

Bezpłatny start

Ucz się Go dzięki korepetycjom AI — za darmo

Pisz i uruchamiaj kod w przeglądarce, otrzymuj natychmiastową pomoc od korepetytora AI dostępnego 24/7 i kontynuuj naukę w sieci lub w aplikacji.

Kursy: 51
Lekcje: 203

Zacznij naukę bezpłatnie Wyświetl pełny kurs

Często zadawane pytania

Czy lekcja „Odczytywanie plików konfiguracyjnych” jest bezpłatna?

Tak — pełny tekst „Odczytywanie plików konfiguracyjnych” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Go Academy, przejdź na CoddyKit PRO. Kurs Go Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Odczytywanie plików konfiguracyjnych”?

Wczytuj YAML, JSON i TOML Ćwiczysz Go Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć Go Academy?

Nie wymagamy żadnego doświadczenia. Go Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 1 z 4.

Ile czasu zajmuje lekcja „Odczytywanie plików konfiguracyjnych”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji Go Academy?

Tak. Każda lekcja Go Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

← Powrót do Go Academy