{"canonical_url":"https://engineer.company/da/glossary/semantic-versioning/","content_markdown":"# Semantisk versionering\n\n## Hvad det er\n\nSemantisk versionering, på engelsk semantic versioning og som regel forkortet\nSemVer, er et sæt regler for, hvordan udgivelser nummereres, så selve nummeret\nfortæller, hvilken slags ændring en udgivelse indeholder. Specifikationen, der\nnu er i version 2.0.0 og oprindeligt blev skrevet af Tom Preston-Werner, bruger\ntre tal på formen MAJOR.MINOR.PATCH. En udgivelse, der bryder det offentlige\nAPI, hæver major-tallet. En udgivelse, der tilføjer funktionalitet på en\nbagudkompatibel måde, hæver minor-tallet, og en, der kun retter fejl uden at\nrøre ved API'et, hæver patch-tallet. Når et tal stiger, sættes tallene til højre\nfor det tilbage til nul, og hvert tal sammenlignes som et tal og ikke som tekst,\nså `1.10.0` kommer efter `1.9.0`.\n\nDet hele hviler på ét krav: Projektet skal erklære et offentligt API, i koden\neller i dokumentationen, for tallene beskriver ændringer i netop det API og\nintet andet. Når en version først er udgivet, må dens indhold ikke ændres; en\nrettelse er en ny version. Major-version nul, `0.y.z`, er til den indledende\nudvikling, hvor alt kan ændre sig når som helst, og hvor API'et ikke bør\nbetragtes som stabilt. Version `1.0.0` er det punkt, hvor det offentlige API\nbliver defineret, og derfra følger tallene, hvordan det ændrer sig.\n\nTo valgfrie tilføjelser udvider formatet. En pre-release skrives efter en\nbindestreg og sorteres før den udgivelse, den fører frem til, så `1.0.0-alpha`\nkommer før `1.0.0-alpha.1`, der igen kommer før `1.0.0-beta`, `1.0.0-rc.1` og\ntil sidst `1.0.0`. Build-metadata skrives efter et plustegn, som i\n`1.0.0+20130313144700`, og ignoreres, når versioner sættes i rækkefølge, så to\nversioner, der kun adskiller sig dér, har samme forrang. Et foranstillet v, som\ni Git-tagget `v1.2.3`, er ikke en del af den semantiske version; specifikationen\nkalder det en almindelig måde at vise på, at der er tale om et versionsnummer.\nGo gør det til et krav: En kanonisk version af et Go-modul er bogstavet v\nefterfulgt af en semantisk version.\n\n## Hvorfor det betyder noget\n\nSpecifikationen tager udgangspunkt i det, den kalder afhængighedshelvede. Er\nafhængighederne angivet for stramt, ender man i versionslåsning, hvor man ikke\nkan opgradere én pakke uden at udgive nye versioner af alt, der afhænger af den.\nEr de angivet for løst, ender man i versionspromiskuitet og antager\nkompatibilitet med flere fremtidige versioner, end der er rimeligt. Et\nversionsnummer med en aftalt betydning gør det muligt for et projekt at sige,\nhvad det vil acceptere: Et bibliotek, der bruger en funktion, som først kom med\ni 3.1.0, kan acceptere alt fra 3.1.0 og op til, men ikke med, 4.0.0 og få senere\nrettelser og tilføjelser med, uden at nogen skal redigere kravet.\n\nPakkehåndteringsværktøjerne handler på det løfte uden at spørge. I Cargo, Rusts\npakkehåndtering, er et almindeligt krav som `\"1.2.3\"` et caret-krav og betyder\nmindst 1.2.3, men under 2.0.0. Når Cargo skriver `Cargo.lock`, vælger den den\nhøjeste version inden for det interval, og den bliver på 1.x-linjen, efter at\n2.0.0 er udgivet, fordi den betragter 2.0.0 som inkompatibel. I node-semver, der\npræsenterer sig som npm's værktøj til semantiske versioner, betyder `^1.2.3` det\nsamme som `\u003e=1.2.3 \u003c2.0.0-0`, og `~1.2.3` tillader kun ændringer på\npatch-niveau, `\u003e=1.2.3 \u003c1.3.0-0`. Go bygger reglen ind i importstierne: Fra\nmajor-version 2 og frem skal et moduls sti ende med et suffiks som `/v2`, så to\ninkompatible major-versioner er to forskellige importstier. Derefter tager Go\nmed minimal version selection for hvert modul den højeste version, som et krav\nbeder om, og det er den laveste version, der opfylder dem alle. Resultatet\ngemmes ikke i en låsefil; hver modulbevidst kommando beregner det igen.\n\nIntet af dette gør nummeret til en garanti. Det er et løfte fra dem, der udgiver\npakken, og det er aldrig bedre end deres vurdering af, hvad der tæller som et\nbrud. Derfor udgiver Cargo en lang kompatibilitetsguide, der inddeler ændringer\ni major, minor og muligvis brydende. Det meste af guiden handler om ændringer,\nder får kode, som byggede i går, til ikke at bygge i dag. Guiden skriver selv,\nat næsten enhver ændring indebærer en vis risiko for at påvirke opførslen under\nkørsel, og at det som regel er op til vedligeholdernes skøn, om sådan en ændring\ner inkompatibel.\n\n## Sådan ser det ud i praksis\n\nFølg et opdigtet Rust-bibliotek, tally, gennem dets udgivelser. Version 0.4.2 er\nstadig indledende udvikling. Version 1.0.0 erklærer det offentlige API for\nstabilt. Version 1.0.1 retter en afrundingsfejl og er en patch. Version 1.1.0\ntilføjer funktionen `parse_strict` og markerer den gamle `parse` som forældet:\nSpecifikationen kræver en minor-udgivelse for at markere noget som forældet og\nbeder om mindst én sådan udgivelse, før funktionen fjernes. Version 2.0.0\nfjerner `parse` og er en major-udgivelse. Version 2.1.0-rc.1 er en pre-release\naf den næste minor-version.\n\nEt program, der afhænger af tally og tre andre opdigtede crates, angiver sine\nkrav i `Cargo.toml`. Kommentarerne viser det interval, Cargo læser ud af hver\nlinje:\n\n```toml\n[dependencies]\ntally = \"1.0.1\"         # \u003e=1.0.1, \u003c2.0.0: takes 1.1.0, never 2.0.0\nledger = \"0.4.2\"        # \u003e=0.4.2, \u003c0.5.0: 0.5.0 counts as breaking\nstamp = \"~1.2.3\"        # \u003e=1.2.3, \u003c1.3.0: patch releases only\nquill = \"=2.1.0-rc.1\"   # exactly this pre-release\n```\n\nLinjen med `ledger` viser en konvention i værktøjerne og ikke i specifikationen:\nCargo betragter det første tal fra venstre, der ikke er nul, som det, der\nsignalerer et brud, mens specifikationen siger, at alt under 1.0.0 kan ændre sig\nnår som helst. Cargo udelader pre-releases fra et krav, medmindre kravet selv\nnævner en, så kravet `\"2.0\"` ville aldrig hente tallys release candidate. Den\neksakte `=`-form på sidste linje er det tilfælde, hvor Cargos dokumentation\nsiger, at et fuldt specificeret krav kan være berettiget: når man afhænger af en\npre-release og vil undgå brydende ændringer mellem pre-releases. Når versionerne\ner fundet, registreres de i `Cargo.lock`, og `cargo update` flytter dem inden\nfor de intervaller. Med `--locked` giver et build, der ville skulle ændre\nlåsefilen, i stedet en fejl.\n\nDet, nummeret ikke dækker, er alt uden for API'et.\n[Licensgennemgangen af 644 Rust-crates](/da/portfolio/know-the-licence-of-everything-you-ship/),\nudført i september 2026, tjekker licensen på hver crate ved hvert build mod en\ntilladelsesliste. Grunden er, at en rutinemæssig versionsopdatering dybt nede i\nafhængighedsgrafen kan ændre, hvilke vilkår et program må distribueres under,\nuden at nogen opdager det, i en låsefil, der aldrig bliver læst i sin helhed.\nFor at bevise, at tjekket virker, blev det bevidst provokeret til at fejle to\ngange. Den ene gang blev en crates licensudtryk omskrevet, hvilket svarer til en\ncrate, der ændrer sine vilkår upstream mellem versioner, og det fanger en\nmenneskelig gennemgang ikke, fordi selve craten ikke er ny. Den anden gang blev\nden fastlåste kernerevision flyttet, uden at gennemgangen blev genereret igen.\nEn semantisk version kan fortælle dig, at 1.4.0 er ment til at virke med kode,\nder er skrevet mod 1.0.0. Den kan ikke fortælle dig, at du stadig må sende den\nud.\n\n## Hvor det går galt\n\n**Et brud i en minor-udgivelse.** Det sker ved et uheld, eller fordi man ser\nforskelligt på, hvad der tæller som et brud. Cargos guide nævner ændringer, der\nser harmløse ud, men ikke er det: At tilføje en variant til en offentlig enum\nbryder kode, der matcher udtømmende på den, medmindre enum'en var markeret med\n`#[non_exhaustive]` fra starten, og i sjældne tilfælde med glob-importer kan\nselv et nyt offentligt element give en kompileringsfejl. Specifikationens svar,\nnår fejlen bliver opdaget, er at udgive en ny minor-version, der genopretter\nkompatibiliteten, aldrig at ændre den udgivelse, der allerede er ude, og at\nfortælle brugerne, hvilken version der var skyld i det. Hos dem, der bruger\npakken, er det en låsefil, der ligger i repositoryet, og test, der kører ved\nhver opdatering, som fanger bruddet, før produktionen gør det.\n\n**At blive på 0.x i årevis.** Ifølge specifikationen har major-version nul slet\nikke et stabilt API. Dens FAQ siger det ligeud: Bruges softwaren allerede i\nproduktion, bør den efter al sandsynlighed allerede være 1.0.0. Værktøjerne\nudfylder hullet med deres egen konvention: Cargo og node-semver betragter det\nførste tal fra venstre, der ikke er nul, som det brydende, så `^0.2.3`\naccepterer kun flere 0.2.x-udgivelser, og `^0.0.3` accepterer slet ingen\nopdateringer. Et bibliotek, der har stået på 0.x i årevis, har brugere, der\nafhænger af det, men intet defineret løfte til dem. Udgiv 1.0.0, når folk er\nafhængige af API'et; det ændrer et tal, ikke koden.\n\n**At læse mere ind i nummeret, end det siger.** Kompatibilitet efter\nspecifikationen handler om det offentlige API. Cargos guide placerer det at hæve\nden mindste Rust-version, en crate kræver, under muligvis brydende og anbefaler\ngenerelt at behandle det som en minor-ændring, så en minor-opdatering kan stoppe\nbuildet på en ældre toolchain. Sætter man `package.rust-version`, kan Cargos\nresolver forsøge med ældre versioner af craten, når det er nødvendigt.\nLicensvilkår, ydeevne og opførsel, som API'et aldrig har dokumenteret, ligger\nhelt uden for nummeret. Tjek dem for sig, med en licensgennemgang og test, i\nstedet for at udlede dem af en minor-udgivelse.\n\n**To major-versioner i ét build.** Når to afhængigheder kræver inkompatible\nversioner af samme crate, for eksempel 0.6 og 0.7, bygger Cargo dem begge.\nCompileren betragter deres typer som forskellige, selv når navnene er ens. Det\nviser sig som regel som en kompileringsfejl, men nogle gange først under kørsel:\nCargos dokumentation beskriver en downcast, der fejler, fordi objektet blev\noprettet af et bibliotek, der bruger version 1.0.0, mens den kaldende kode\ndowncaster til typen fra 2.0.0. `cargo tree -d` viser dublerede versioner, og\nhvor de kommer fra. En biblioteksforfatter kan gøre en major-udgivelse mindre\nsmertefuld med det, Cargos dokumentation kalder »the semver trick«: Udgiv den\nnye major-version, og udgiv derefter en punktudgivelse af den gamle, der\nreeksporterer typerne fra den nye.\n\n## Læs mere\n\n- [Semantic Versioning 2.0.0](https://semver.org/) — specifikationen og dens\n  FAQ, blandt andet om, hvad man gør, når man ved en fejl har udgivet en\n  brydende ændring. Findes også i dansk oversættelse.\n- [SemVer Compatibility](https://doc.rust-lang.org/cargo/reference/semver.html)\n  — Cargo Books guide til, hvilke ændringer i et Rust-bibliotek der er major,\n  minor eller muligvis brydende, hver med et eksempel.\n- [Specifying Dependencies](https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html)\n  — Cargos syntaks for krav: standard, caret, tilde og sammenligninger, og\n  hvordan pre-releases bliver matchet.\n- [Dependency Resolution](https://doc.rust-lang.org/cargo/reference/resolver.html)\n  — hvordan Cargo vælger versioner, hvad låsefilen indeholder, og farerne ved to\n  inkompatible versioner i samme graf.\n- [node-semver](https://github.com/npm/node-semver) — npm's værktøj til\n  semantiske versioner med reglerne for caret, tilde og pre-releases i\n  intervaller.\n- [Go Modules Reference](https://go.dev/ref/mod) — suffikser for\n  major-versioner, reglen om importkompatibilitet og minimal version selection.\n\n\u003chttps://engineer.company/da/glossary/semantic-versioning/\u003e\n","date_modified":"2026-10-29T11:17:41Z","description":"Hvad MAJOR.MINOR.PATCH lover, hvordan Cargo, npm og Go handler på det, og hvad et versionsnummer ikke kan fortælle dig.","formats":{"gemtext":"https://engineer.company/da/glossary/semantic-versioning/index.gmi","gopher":"https://engineer.company/da/glossary/semantic-versioning/gophermap","html":"https://engineer.company/da/glossary/semantic-versioning/","json":"https://engineer.company/da/glossary/semantic-versioning/index.json","markdown":"https://engineer.company/da/glossary/semantic-versioning/index.md","pdf":"https://engineer.company/da/glossary/semantic-versioning/index.pdf"},"kind":"page","language":"da","title":"Hvad er semantisk versionering?","url":"https://engineer.company/da/glossary/semantic-versioning/","version":1}