{"canonical_url":"https://engineer.company/nb/glossary/semantic-versioning/","content_markdown":"# Semantisk versjonering\n\n## Hva det er\n\nSemantisk versjonering, på engelsk semantic versioning og som regel forkortet\nSemVer, er et sett regler for hvordan utgivelser nummereres, slik at selve\nnummeret forteller hva slags endring en utgivelse inneholder. Spesifikasjonen,\nsom nå er i versjon 2.0.0 og opprinnelig ble skrevet av Tom Preston-Werner,\nbruker tre tall på formen MAJOR.MINOR.PATCH. En utgivelse som bryter det\noffentlige API-et, øker major-tallet. En utgivelse som legger til funksjonalitet\npå en bakoverkompatibel måte, øker minor-tallet, og en som bare retter feil uten\nå røre API-et, øker patch-tallet. Når et tall øker, settes tallene til høyre for\ndet tilbake til null, og hvert tall sammenlignes som et tall og ikke som tekst,\nså `1.10.0` kommer etter `1.9.0`.\n\nAlt hviler på ett krav: prosjektet må erklære et offentlig API, i koden eller i\ndokumentasjonen, fordi tallene beskriver endringer i nettopp det API-et og\ningenting annet. Når en versjon først er utgitt, skal innholdet ikke endres; en\nrettelse er en ny versjon. Major-versjon null, `0.y.z`, er for den innledende\nutviklingen, der alt kan endre seg når som helst, og der API-et ikke bør regnes\nsom stabilt. Versjon `1.0.0` er punktet der det offentlige API-et blir definert,\nog derfra følger tallene hvordan det endrer seg.\n\nTo valgfrie merkelapper utvider formatet. En forhåndsutgivelse (pre-release)\nskrives etter en bindestrek og sorteres før utgivelsen den leder fram til, så\n`1.0.0-alpha` kommer før `1.0.0-alpha.1`, som igjen kommer før `1.0.0-beta`,\n`1.0.0-rc.1` og til slutt `1.0.0`. Byggmetadata skrives etter et plusstegn, som\ni `1.0.0+20130313144700`, og ignoreres når versjoner settes i rekkefølge, så to\nversjoner som bare skiller seg der, rangeres likt. En v foran, som i Git-taggen\n`v1.2.3`, er ikke en del av den semantiske versjonen; spesifikasjonen kaller det\nen vanlig måte å vise at det dreier seg om et versjonsnummer. Go gjør det til et\nkrav: en kanonisk versjon av en Go-modul er bokstaven v fulgt av en semantisk\nversjon.\n\n## Hvorfor det er viktig\n\nSpesifikasjonen tar utgangspunkt i det den kaller avhengighetshelvete\n(dependency hell). Angir du avhengigheter for stramt, får du versjonslås\n(version lock), der oppgradering av én pakke krever nye versjoner av alt som er\navhengig av den. Angir du dem for løst, får du det spesifikasjonen kaller\nversion promiscuity: du antar kompatibilitet med flere framtidige versjoner enn\ndet er rimelig. Et versjonsnummer med avtalt betydning lar et prosjekt si hva\ndet godtar: et bibliotek som trenger en funksjon som først kom i 3.1.0, kan\ngodta alt fra 3.1.0 og opp til, men ikke med, 4.0.0, og få senere rettelser og\ntillegg uten at noen redigerer kravet.\n\nPakkebehandlere handler ut fra dette løftet uten å spørre. I Cargo,\npakkebehandleren for Rust, er et vanlig krav som `\"1.2.3\"` et caret-krav og\nbetyr minst 1.2.3, men under 2.0.0. Når Cargo skriver `Cargo.lock`, velger det\nden høyeste versjonen innenfor det intervallet, og det blir værende på 1.x etter\nat 2.0.0 er publisert, fordi det regner 2.0.0 som inkompatibel. I node-semver,\nsom kaller seg den semantiske versjonsbehandleren for npm, betyr `^1.2.3` det\nsamme som `\u003e=1.2.3 \u003c2.0.0-0`, og `~1.2.3` tillater bare endringer på patch-nivå,\n`\u003e=1.2.3 \u003c1.3.0-0`. Go bygger regelen inn i importstiene: fra major-versjon 2 og\noppover må stien til en modul slutte med et suffiks som `/v2`, så to\ninkompatible major-versjoner er to forskjellige importstier. Minimal version\nselection i Go tar deretter, for hver modul, den høyeste versjonen som noe krav\nber om, og det er den laveste versjonen som oppfyller alle kravene. Resultatet\nlagres ikke i noen låsefil; hver kommando som arbeider med moduler, regner det\nut på nytt.\n\nIngenting av dette gjør nummeret til en garanti. Det er et løfte fra dem som\npubliserer pakken, og det er aldri bedre enn deres vurdering av hva som regnes\nsom brytende. Derfor publiserer Cargo en lang kompatibilitetsguide som sorterer\nendringer i major, minor og muligens brytende (possibly-breaking). Mesteparten\nav guiden handler om endringer som gjør at kode som kompilerte i går, ikke\nkompilerer i dag. Guiden påpeker selv at nesten enhver endring innebærer en viss\nrisiko for oppførselen under kjøring, og at om en slik endring er inkompatibel,\nsom regel er et skjønnsspørsmål for vedlikeholderne.\n\n## Slik ser det ut i praksis\n\nFølg et oppdiktet Rust-bibliotek, tally, gjennom utgivelsene. Versjon 0.4.2 er\nfortsatt innledende utvikling. Versjon 1.0.0 erklærer det offentlige API-et\nstabilt. Versjon 1.0.1 retter en avrundingsfeil og er en patch. Versjon 1.1.0\nlegger til en funksjon, `parse_strict`, og merker den gamle `parse` som foreldet\n(deprecated): spesifikasjonen krever en minor-utgivelse for det og ber om minst\nén slik utgivelse før funksjonen fjernes. Versjon 2.0.0 fjerner `parse` og er en\nmajor-utgivelse. Versjon 2.1.0-rc.1 er en forhåndsutgivelse av den neste\nminor-versjonen.\n\nEn applikasjon som er avhengig av tally og tre andre oppdiktede crates, angir\nkravene sine i `Cargo.toml`. Kommentarene viser intervallet Cargo leser ut av\nhver linje:\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 for `ledger` viser en konvensjon i verktøyene og ikke i spesifikasjonen:\nfor Cargo er det første tallet fra venstre som ikke er null, det som\nsignaliserer brudd, mens spesifikasjonen sier at alt under 1.0.0 kan endre seg\nnår som helst. Cargo holder forhåndsutgivelser utenfor et krav med mindre kravet\nnevner en, så et krav på `\"2.0\"` ville aldri plukke opp utgivelseskandidaten til\ntally. Den eksakte `=`-formen på siste linje er det tilfellet der Cargos\ndokumentasjon sier at et fullt spesifisert krav kan være berettiget: å være\navhengig av en forhåndsutgivelse og samtidig unngå brytende endringer mellom\nforhåndsutgivelser. Når versjonene er valgt, registreres de i `Cargo.lock`,\nog `cargo update` flytter dem innenfor disse intervallene. Med `--locked`\nreturnerer et bygg som måtte ha endret låsefilen, en feil i stedet.\n\nDet nummeret ikke dekker, er alt utenfor API-et.\n[Lisensrevisjonen av 644 Rust-crates](/nb/portfolio/know-the-licence-of-everything-you-ship/),\nutført i september 2026, sjekker lisensen til hver crate ved hver bygging mot en\nliste over vilkår prosjektet godtar, fordi en rutinemessig versjonsoppgradering\ndypt nede i avhengighetsgrafen i det stille kan endre hvilke vilkår en app kan\ndistribueres under, i en låsefil ingen leser linje for linje. For å bevise at\nsjekken virker, ble den provosert til å feile med vilje, to ganger. Den ene\ngangen ble lisensuttrykket til en crate skrevet om, slik det ser ut når en crate\nendrer vilkårene sine oppstrøms mellom versjoner, noe ingen menneskelig\ngjennomgang fanger, fordi selve craten ikke er ny. Den andre gangen ble den\nlåste kjernerevisjonen flyttet uten at lisenskontrollen ble generert på nytt. En\nsemantisk versjon kan fortelle deg at 1.4.0 er ment å virke med kode skrevet mot\n1.0.0. Den kan ikke fortelle deg om du fortsatt har lov til å levere den.\n\n## Hvor det går galt\n\n**En brytende endring i en minor-utgivelse.** Det skjer ved et uhell eller fordi\nman ser forskjellig på hva som er brytende. Cargos guide lister opp endringer\nsom ser harmløse ut, men ikke er det: å legge til en variant i en offentlig enum\nbryter kode som matcher uttømmende på den, med mindre enumen var merket\n`#[non_exhaustive]` fra starten, og i sjeldne tilfeller med glob-importer gir\ntil og med et nytt offentlig element en kompileringsfeil. Spesifikasjonens svar,\nnår feilen er oppdaget, er å gi ut en ny minor-versjon som gjenoppretter\nkompatibiliteten, aldri å endre utgivelsen som allerede er publisert, og å\nfortelle brukerne hvilken versjon som var feil. På mottakersiden er det en\nlåsefil som er sjekket inn i repoet, og tester som kjører ved hver oppdatering,\nsom fanger feilen før den når produksjon.\n\n**Å bli stående på 0.x i årevis.** Etter spesifikasjonen har major-versjon null\nikke noe stabilt API i det hele tatt. FAQ-en sier det rett ut: brukes\nprogramvaren allerede i produksjon, bør den etter all sannsynlighet allerede\nvære 1.0.0. Verktøyene fyller tomrommet med sin egen konvensjon: Cargo og\nnode-semver regner det første tallet fra venstre som ikke er null, som det\nbrytende, så `^0.2.3` godtar bare flere 0.2.x-utgivelser, og `^0.0.3` godtar\ningen oppdateringer i det hele tatt. Et bibliotek som har stått på 0.x i årevis,\nhar brukere som er avhengige av det, men ikke noe definert løfte til dem. Gi ut\n1.0.0 når folk først stoler på API-et; det endrer et nummer, ikke koden.\n\n**Å lese mer ut av nummeret enn det sier.** Kompatibilitet etter spesifikasjonen\nhandler om det offentlige API-et. Cargos guide klassifiserer det å heve den\nminste Rust-versjonen en crate trenger, som muligens brytende og anbefaler\ngenerelt å behandle det som en minor-endring, så en minor-oppdatering kan stoppe\nbygget på en eldre verktøykjede. Når `package.rust-version` er satt, kan Cargos\navhengighetsoppløser prøve eldre versjoner av craten ved behov. Lisensvilkår,\nytelse og oppførsel som API-et aldri har dokumentert, ligger helt utenfor\nnummeret. Sjekk dem for seg, med en lisensrevisjon og tester, i stedet for å\nutlede dem av en minor-utgivelse.\n\n**To major-versjoner i ett bygg.** Når to avhengigheter trenger inkompatible\nversjoner av samme crate, for eksempel 0.6 og 0.7, bygger Cargo begge.\nKompilatoren behandler typene deres som forskjellige, selv når navnene er like.\nSom regel viser det seg som en kompileringsfeil, og noen ganger først under\nkjøring: Cargos dokumentasjon beskriver en downcast som feiler fordi objektet\nble laget av et bibliotek som brukte versjon 1.0.0, mens koden som kaller,\nprøver å downcaste til typen fra 2.0.0. Kommandoen `cargo tree -d` viser\ndupliserte versjoner og hvor de kommer fra. En bibliotekforfatter kan dempe en\nmajor-utgivelse med det Cargos dokumentasjon kaller «the semver trick»: publiser\nden nye major-versjonen, og deretter en punktutgivelse av den gamle som\nre-eksporterer typene fra den nye.\n\n## Les mer\n\n- [Semantic Versioning 2.0.0](https://semver.org/) — spesifikasjonen og FAQ-en,\n  blant annet om hva man gjør etter å ha gitt ut en brytende endring ved en\n  feil.\n- [SemVer Compatibility](https://doc.rust-lang.org/cargo/reference/semver.html)\n  — Cargo-bokens guide til hvilke endringer i et Rust-bibliotek som er major,\n  minor eller muligens brytende, hver med et eksempel.\n- [Specifying Dependencies](https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html)\n  — Cargos kravsyntaks: standard-, caret-, tilde- og sammenligningskrav, og\n  hvordan forhåndsutgivelser matches.\n- [Dependency Resolution](https://doc.rust-lang.org/cargo/reference/resolver.html)\n  — hvordan Cargo velger versjoner, hva låsefilen inneholder, og farene ved to\n  inkompatible versjoner i én graf.\n- [node-semver](https://github.com/npm/node-semver) — den semantiske\n  versjonsbehandleren for npm, med reglene for caret, tilde og intervaller med\n  forhåndsutgivelser.\n- [Go Modules Reference](https://go.dev/ref/mod) — suffikser for\n  major-versjoner, regelen for importkompatibilitet og minimal version\n  selection.\n\n\u003chttps://engineer.company/nb/glossary/semantic-versioning/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Hva MAJOR.MINOR.PATCH lover, hvordan Cargo, npm og Go handler ut fra det, og hva et versjonsnummer ikke kan fortelle deg.","formats":{"gemtext":"https://engineer.company/nb/glossary/semantic-versioning/index.gmi","gopher":"https://engineer.company/nb/glossary/semantic-versioning/gophermap","html":"https://engineer.company/nb/glossary/semantic-versioning/","json":"https://engineer.company/nb/glossary/semantic-versioning/index.json","markdown":"https://engineer.company/nb/glossary/semantic-versioning/index.md","pdf":"https://engineer.company/nb/glossary/semantic-versioning/index.pdf"},"kind":"page","language":"nb","title":"Hva er semantisk versjonering?","url":"https://engineer.company/nb/glossary/semantic-versioning/","version":1}