Hvad er YAML-filformatet?
.yaml er et tekstfilformat, der bruges til at udveksle data mellem forskellige applikationer. YAML - forkortelse for *YAML Ain't Markup Language* - er en standard til organisering af information i et menneskelæsbart, platformuafhængigt format ved hjælp af indrykningsbaserede key: value-par kodet i UTF-8. Parsing af .yaml-filer kræver, at et YAML-bibliotek er installeret; populære biblioteker inkluderer PyYAML (Python), js-yaml (JavaScript) og SnakeYAML (Java). .yaml-filer gemmes undertiden med filtypenavnet .yml, som er funktionelt identisk. Udover dataudveksling bruges .yaml-filer typisk til serialisering af data og til at skrive konfigurationsfiler i værktøjer som Docker Compose, Kubernetes og GitHub Actions.
Serialisering
Serialisering er et begreb, der bruges inden for datalogi. Serialisering er en proces, hvor data eller objekter oversættes til et format, der kan gemmes, transmitteres og rekonstrueres senere. For eksempel skal to institutioner, der udveksler data i et standardiseret format ved hjælp af forskellige applikationer, serialisere disse data, før de sendes. Serialiserede data kan også gemmes i en fil - .yaml, .xml, .json, .toml osv. - og derefter sendes til modtagerne.
Et .yaml-dokument kan valgfrit begynde med --- (dokumentstart-markør) og slutte med ...; dette tillader også flere dokumenter i en enkelt fil. Siden YAML 1.2 (2009, revideret 2021) er enhver gyldig JSON-fil også gyldig YAML.
Sikkerhed og tryghed
RISIKO: MEDIUMEn YAML-fil er almindelig tekst og eksekveres ikke i sig selv, så det er sikkert at læse en. To reelle risici: (1) konfigurations-YAML (CI-pipelines, Compose, K8s, Ansible) indeholder ofte hemmeligheder - tokens, adgangskoder, nøgler - så indsæt den ikke i upålidelige online-validatorer eller commit den offentligt. (2) Programmatisk fare: indlæsning af upålidelig YAML med en usikker parser (f.eks. PyYAMLs yaml.load i stedet for yaml.safe_load) kan eksekvere vilkårlige objekter/kode - brug altid den sikre loader til filer, du ikke stoler på. Redigeringsrisiko: et tabulatortegn eller et forkert placeret mellemrum ændrer lydløst betydningen, så valider efter redigering.
Formatdetaljer
kort fortaltFULDSTÆNDIGT NAVNYAML Ain't Markup Language file
UDVIKLERClark Evans, Ingy döt Net, Oren Ben-Kiki (YAML spec)siden 2001 (YAML 1.0); YAML 1.1 (2005); current YAML 1.2 (2009, revised 2021)
KATEGORIUdviklerfiler
MIME-TYPEapplication/yaml
TYPEMenneskelæsbar dataserialiseringstekst (indrykningsbaseret, UTF-8)
STANDARDÅben · royaltyfri
Programmer der åbner YAML-filer
Windows4 apps
Sublime Text
Freemium Åbn .yaml for hurtig redigering med YAML-fremhævning; konfigurer «translate tabs to spaces», så indrykningen forbliver gyldig. 
Windows Notepad
Indbygget Åbner YAML som tekst for et hurtigt kig - men den viser ikke whitespace/tabs, så det er risikabelt til redigering af indrykningsfølsom YAML. 
Notepad
Open-source Åbn med YAML-syntaksfremhævning; slå View > Show Symbol > Show White Space til for at holde indrykningen korrekt. 
Visual Studio Code
Gratis Åbn filen; den indbyggede/Red Hat YAML-udvidelse giver fremhævning, indrykningsguider, skemavalidering og fejlmarkeringer. Det bedste valg til YAML. 
macOS3 apps
TextEdit
Indbygget Format > Make Plain Text først, og deaktiver «smart quotes» - men den viser ikke whitespace, så foretræk en kodeeditor til redigering.
Visual Studio Code
Gratis Åbn filen; den indbyggede/Red Hat YAML-udvidelse giver fremhævning, indrykningsguider, skemavalidering og fejlmarkeringer. Det bedste valg til YAML. 
Sublime Text / BBEdit
Freemium Åbn .yaml i en kodeeditor for korrekt YAML-fremhævning og mellemrumsbaseret indrykning. 
Linux3 apps
Visual Studio Code
Gratis Åbn filen; den indbyggede/Red Hat YAML-udvidelse giver fremhævning, indrykningsguider, skemavalidering og fejlmarkeringer. Det bedste valg til YAML.
GNOME Text Editor / gedit
Open-source Åbn med YAML-fremhævning; indstil den til at indsætte mellemrum (ikke tabs) før redigering.
vim / nano
Open-source Rediger i terminalen; i Vim bruges «:set expandtab», så indrykning bruger mellemrum. Standard for serverkonfigurationsfiler.
Web1 app
YAML Lint / online YAML validators
Gratis Indsæt filen for at validere syntaks og formatere den pænt i browseren. Indsæt ikke hemmeligheder - konfigurations-YAML indeholder ofte loginoplysninger. Tekniske detaljer
dyb specifikation| Filtypenavn | .yaml (også .yml) |
| MIME-type | application/yaml |
| Kodning | UTF-8 almindelig tekst; ingen binær header eller magic bytes |
| Struktur | Indrykningsbaserede key: value-par; indrykning bruger kun mellemrum - tabulatortegn er forbudt ifølge specifikationen |
| Dokumentmarkører | --- markerer dokumentstart, ... markerer dokumentslut; flere dokumenter kan eksistere i én fil |
| Indfødte datatyper | Strenge, heltal, flydende tal, booleans, null, sekvenser (lister), mappings (ordbøger), tidsstempler |
| Specifikationsversion | YAML 1.2 (2009, revideret 2021); erstatter YAML 1.1 (2005) og YAML 1.0 (2001) |
| JSON-kompatibilitet | Siden YAML 1.2 er ethvert gyldigt JSON-dokument også gyldig YAML - JSON er en streng delmængde |
| Kommentarer | Enkeltlinjekommentarer introduceret med # ; kan optræde på deres egen linje eller inline efter en værdi |
| Flerlinjede strenge | Literal block scalar (|) bevarer linjeskift; folded scalar (>) konverterer linjeskift til mellemrum |
| Ankre og aliaser | & definerer et navngivet anker og * refererer (aliaser) til det, hvilket muliggør genbrug af værdier uden duplikering |
| Udviklere | Clark Evans, Ingy döt Net, Oren Ben-Kiki |
| Almindelige anvendelsesscenarier | Konfigurationsfiler (Kubernetes, Docker Compose, GitHub Actions, Ansible), dataserialisering, OpenAPI-definitioner |
| Anførselstegn | Strenge uden anførselstegn, med enkelte ('...') og dobbelte ("...") anførselstegn understøttes alle; dobbelte tillader escape-sekvenser |
| Udgivet | 2001 (YAML 1.0); YAML 1.1 (2005); current YAML 1.2 (2009, revised 2021) |
| Åben standard | Ja · royaltyfri |
| Specifikation | yaml.org |
YAML-konverteringer
Muligt
.YAML .JSONOnline konverter
Ja - YAML og JSON deler den samme datamodel, så konverteringen er tabsfri; kun YAML-kommentarer fjernes.
Sådan konverterer du
.YAML .XMLOnline konverter
Ja - YAML og XML beskriver begge hierarkiske data, så konvertering er ligetil, selvom hver YAML-nøgle bliver…
Sådan konverterer du
.YAML .TOMLGUIDE
Ja, YAML kan konverteres til TOML -- den hurtigste metode er en yq-kommando: yq -o=toml file.yaml > file.toml.
Sådan konverterer du
.YAML .CSVGUIDE
Ja - men kun når .yaml-filen er en flad, ensartet liste af poster; indlejrede konfigurationer som…
Sådan konverterer du
.YAML .YMLGUIDE
Ja - .yaml og .yml er det samme format; omdøbning af filen er alt, hvad du behøver at gøre.
Sådan konverterer du
Ikke muligt
Fællesskabets Q&A
spurgt af brugere
I
Ofte stillede spørgsmål
Hvad er forskellen på .yaml og .yml?
Ingen - de er det samme YAML-format med to filtypenavne. .yml er den ældre form på 3 bogstaver. Brug det, som værktøjet forventer; du kan blot omdøbe filen.
Hvordan åbner jeg en .yaml-fil?
Med enhver kode- eller teksteditor. VS Code (med YAML-udvidelsen) er bedst, fordi den fremhæver strukturen og markerer indrykningsfejl; Notepad++ og Sublime fungerer også. Det er almindelig tekst, så Notepad kan åbne den - men den viser ikke usynlige tegn (whitespace), som YAML er afhængig af.
Hvorfor giver min YAML en indryknings- eller parse-fejl?
YAML bruger mellemrum til struktur og forbyder tabulatortegn, så et vildfarende tabulatortegn eller en forkert indrykket linje ødelægger det. Åbn den i en YAML-kyndig editor (vis whitespace, konverter tabs til mellemrum) eller indsæt den i en online YAML-validator for at finde den nøjagtige linje.
Hvordan konverterer jeg YAML til JSON?
Brug «yq -o=json file.yaml», en VS Code-kommando eller en online-konverter. Det er i det væsentlige tabsløst (lossless), da JSON er en delmængde af YAML - kun kommentarer fjernes.
Kan jeg bruge tabulatortegn i YAML?
Nej. YAML tillader kun mellemrum til indrykning; tabulatortegn forårsager en parse-fejl. Indstil din editor til at indsætte mellemrum (f.eks. «:set expandtab» i Vim, eller «translate tabs to spaces» i Sublime).
Er YAML kun til Python?
Nej - det er en almindelig misforståelse. YAML er sproguafhængigt og bruges overalt: Docker Compose, Kubernetes, GitHub Actions, Ansible, Go/Java/JS-apps og mere. Python har tilfældigvis bare et populært YAML-bibliotek (PyYAML).
Referencer
1YAML 1.2.2 Specification (yaml.org)yaml.org
2yaml.org - official site & resourcesyaml.org
