Notice: This page requires JavaScript to function properly.
Please enable JavaScript in your browser settings or update your browser.
Lære Commit-meldinger | Introduksjon til Git
Git Essentials

bookCommit-meldinger

Hvorfor commit-meldinger er viktige

Commit-meldinger spiller en avgjørende rolle for å forstå historikken til et prosjekt. Godt utformede commit-meldinger gjør det enklere for samarbeidspartnere, fremtidige utviklere og deg selv å forstå hensikten og konteksten til hver endring. En tydelig commit-historikk legger til rette for samarbeid, feilsøking og prosessen med å identifisere spesifikke endringer i prosjektets tidslinje.

Oppbygning av en god commit-melding

1. Kortfattethet og klarhet

En commit-melding bør være kortfattet og presis. Den skal tydelig formidle hensikten med commiten i én linje. Unngå uklarhet og gi nok informasjon til å forstå endringen uten å måtte se på selve koden.

Bad: "Fixed a bug"
Good: "Fix issue with user authentication in login form"

2. Skill mellom emne og brødtekst

Hvis det er behov for flere detaljer, skill emnet fra brødteksten i commit-meldingen med en tom linje. Emnet skal oppsummere endringen, mens brødteksten kan gi ytterligere kontekst, begrunnelser for endringen og annen relevant informasjon.

La oss se på et eksempel på en slik commit-melding:

Subject: "Add validation for user email input"

Body: "This commit introduces email format validation to ensure
that users provide a valid email address when registering. It
helps improve the overall data integrity of the system."

I dette tilfellet vil vi imidlertid bare kjøre kommandoen git commit uten flagget -m:

Standard tekstredigerer for Git vil åpnes, hvor du kan skrive en detaljert commit-melding. Deretter bør du lagre og avslutte tekstredigereren på riktig måte.

La oss gjøre en ny commit i vårt repository:

Her er kommandoen vi brukte for å endre tekstfilen vår:

Commit-meldingen er som følger:

Hvis du ikke kan redigere filen, trykk på i-tasten. Dette sørger for at du går inn i redigeringsmodus. For å lagre endringer og avslutte Vim, trykk på Escape-tasten og to store Z-bokstaver.

Note
Merk

Hvis du har en annen standard teksteditor for terminalen (enn Vim), og opplever problemer, kan du enkelt finne ut hvordan du lagrer endringer og avslutter den på internett.

3. Bruk imperativ form

Skriv commit-meldinger i imperativ form, noe som gir en tydelig retning for endringen. Start emnet med et verb, som "Fix", "Add" eller "Update".

Bad: "Fixed the issue with the login form"
Good: "Fix issue with user authentication in login form"
Alt var klart?

Hvordan kan vi forbedre det?

Takk for tilbakemeldingene dine!

Seksjon 1. Kapittel 10

Spør AI

expand

Spør AI

ChatGPT

Spør om hva du vil, eller prøv ett av de foreslåtte spørsmålene for å starte chatten vår

Suggested prompts:

Can you explain why using the imperative mood is important in commit messages?

What are some other examples of good commit messages?

How can I practice writing better commit messages?

Awesome!

Completion rate improved to 3.57

bookCommit-meldinger

Sveip for å vise menyen

Hvorfor commit-meldinger er viktige

Commit-meldinger spiller en avgjørende rolle for å forstå historikken til et prosjekt. Godt utformede commit-meldinger gjør det enklere for samarbeidspartnere, fremtidige utviklere og deg selv å forstå hensikten og konteksten til hver endring. En tydelig commit-historikk legger til rette for samarbeid, feilsøking og prosessen med å identifisere spesifikke endringer i prosjektets tidslinje.

Oppbygning av en god commit-melding

1. Kortfattethet og klarhet

En commit-melding bør være kortfattet og presis. Den skal tydelig formidle hensikten med commiten i én linje. Unngå uklarhet og gi nok informasjon til å forstå endringen uten å måtte se på selve koden.

Bad: "Fixed a bug"
Good: "Fix issue with user authentication in login form"

2. Skill mellom emne og brødtekst

Hvis det er behov for flere detaljer, skill emnet fra brødteksten i commit-meldingen med en tom linje. Emnet skal oppsummere endringen, mens brødteksten kan gi ytterligere kontekst, begrunnelser for endringen og annen relevant informasjon.

La oss se på et eksempel på en slik commit-melding:

Subject: "Add validation for user email input"

Body: "This commit introduces email format validation to ensure
that users provide a valid email address when registering. It
helps improve the overall data integrity of the system."

I dette tilfellet vil vi imidlertid bare kjøre kommandoen git commit uten flagget -m:

Standard tekstredigerer for Git vil åpnes, hvor du kan skrive en detaljert commit-melding. Deretter bør du lagre og avslutte tekstredigereren på riktig måte.

La oss gjøre en ny commit i vårt repository:

Her er kommandoen vi brukte for å endre tekstfilen vår:

Commit-meldingen er som følger:

Hvis du ikke kan redigere filen, trykk på i-tasten. Dette sørger for at du går inn i redigeringsmodus. For å lagre endringer og avslutte Vim, trykk på Escape-tasten og to store Z-bokstaver.

Note
Merk

Hvis du har en annen standard teksteditor for terminalen (enn Vim), og opplever problemer, kan du enkelt finne ut hvordan du lagrer endringer og avslutter den på internett.

3. Bruk imperativ form

Skriv commit-meldinger i imperativ form, noe som gir en tydelig retning for endringen. Start emnet med et verb, som "Fix", "Add" eller "Update".

Bad: "Fixed the issue with the login form"
Good: "Fix issue with user authentication in login form"
Alt var klart?

Hvordan kan vi forbedre det?

Takk for tilbakemeldingene dine!

Seksjon 1. Kapittel 10
some-alt