YAML

Dataserialiseringsformat

Dataserialisering är processen att konvertera strukturerad data till ett format som kan lagras eller överföras och senare rekonstrueras. Olika format gör olika avvägningar mellan läsbarhet för människor, maskinparsning, uttrycksfullhet och filstorlek. Valet av serialiseringsformat påverkar direkt hur enkelt det är att felsöka, versionsstyra och samarbeta kring konfiguration i ett team.

JSON, YAML, TOML och XML är de fyra dominerande textbaserade serialiseringsformaten inom mjukvaruutveckling. Varje format har styrkor som gör det till det bästa valet i specifika sammanhang — att förstå dessa avvägningar låter dig välja rätt format för varje uppgift. Att känna till när man ska byta format är lika viktigt som att behärska syntaxen i ett enskilt format.

JSON och YAML sida vid sida

JSON och YAML representerar samma datamodell. YAML är en strikt supermängd av JSON — varje giltigt JSON-dokument är också giltigt YAML. Nedan visas samma konfiguration uttryckt i båda formaten:

{
  "server": {
    "host": "localhost",
    "port": 8080,
    "debug": true
  },
  "database": {
    "url": "postgres://localhost/mydb",
    "pool": 10
  }
}

server:
  host: localhost
  port: 8080
  debug: true
database:
  url: postgres://localhost/mydb
  pool: 10

YAML använder indragning i stället för klamrar och hakparenteser, och utelämnar citattecken kring de flesta strängvärden. Det gör det mer kompakt och läsbart för manuellt redigerade filer, men introducerar indragningskänslighet. För maskingenerade filer och API-svar är JSON vanligtvis att föredra eftersom det inte är beroende av blanksteg för att definiera struktur.

Formatjämförelse

Vanliga fallgropar i YAML

YAML är kraftfullt men har välkända kantfall som överraskar utvecklare. Dessa är de vanligaste. Att känna till dem i förväg sparar tid i felsökning och minskar risken för svårspårade fel i produktion.

Funktioner unika för YAML

Kommentarer

YAML stöder kommentarer med #-tecknet. Det är en av de största praktiska fördelarna jämfört med JSON för konfigurationsfiler — du kan dokumentera dina inställningar direkt i filen. Kommentarer kan stå på en egen rad eller efter ett värde. Det är god praxis att använda kommentarer för att förklara varför ett värde är valt, inte bara vad det är, särskilt för parametrar som timeouts och resursbegränsningar.

Ankare och alias

YAML låter dig definiera en nod en gång med &ankarnamn och återanvända den var som helst med *ankarnamn. Det eliminerar upprepning i komplexa konfigurationer. Kubernetes och Docker Compose använder ankare flitigt för delade tjänstedefinitioner. Med merge-nyckeln (<<: *ankarnamn) kan du dessutom slå ihop en refererad mappning med ytterligare nycklar, vilket ger en form av arv i konfigurationsfiler.

Flerradiga strängar

YAML stöder blockskalar med två lägen: det literala blocket (|) bevarar radbrytningar exakt som de är skrivna, vilket är användbart för skript och mallar. Det vikta blocket (>) bryter långa strängar till en enda rad, användbart för långa textbeskrivningar. Båda lägena stöder indragningsindikatorer (t.ex. |2) som låter dig styra exakt hur mycket inledande blanksteg som tas bort vid parsning.

När du behöver konvertera

Vanliga frågor