Notice: This page requires JavaScript to function properly.
Please enable JavaScript in your browser settings or update your browser.
Lära Commit-meddelanden | Introduktion till Git
Git-Grunder

bookCommit-meddelanden

Varför commit-meddelanden är viktiga

Commit-meddelanden är avgörande för att förstå ett projekts historik. Tydliga och meningsfulla meddelanden hjälper samarbetspartners, framtida utvecklare och dig själv att förstå syftet och sammanhanget för varje ändring. En välstrukturerad commit-historik förbättrar samarbetet, förenklar felsökning och gör det enklare att spåra specifika ändringar i projektets tidslinje.

Anatomien av ett bra commit-meddelande

1. Kortfattat och tydligt

Ett commit-meddelande ska vara kortfattat och direkt. Det ska tydligt förmedla syftet med commiten i en enda rad. Undvik tvetydighet och ge tillräcklig information för att förstå ändringen utan att behöva titta på själva koden.

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

2. Separera ämne från brödtext

Om mer information behövs, separera ämnet från brödtexten i commit-meddelandet med en tom rad. Ämnet ska sammanfatta ändringen, och brödtexten kan ge ytterligare sammanhang, skäl till ändringen och annan relevant information.

Låt oss titta på ett exempel på ett sådant commit-meddelande:

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 detta fall, kör kommandot git commit utan flaggan -m:

Den förvalda textredigeraren för Git kommer att öppnas, där du kan skriva ett detaljerat commit-meddelande. Du ska sedan spara det och avsluta textredigeraren på lämpligt sätt.

Låt oss göra ytterligare en commit i vårt arkiv:

Här är kommandot som används för att ändra textfilen:

Commit-meddelandet enligt följande:

Om du inte kan redigera filen, tryck på i-tangenten. Detta säkerställer att du går in i redigeringsläget. För att spara ändringar och avsluta Vim, tryck på Escape-tangenten och två stora Z-bokstäver.

Note
Notera

Om du har en annan standardtextredigerare för terminalen (än Vim) och stöter på några svårigheter, kan du enkelt hitta hur du sparar ändringar och avslutar den på internet.

3. Använd imperativ form

Skriv commit-meddelanden i imperativ form, vilket ger en tydlig riktning för ändringen. Börja ämnesraden med ett verb, såsom "Fix", "Add" eller "Update".

Bad: "Fixed the issue with the login form"
Good: "Fix issue with user authentication in login form"
Var allt tydligt?

Hur kan vi förbättra det?

Tack för dina kommentarer!

Avsnitt 1. Kapitel 10

Fråga AI

expand

Fråga AI

ChatGPT

Fråga vad du vill eller prova någon av de föreslagna frågorna för att starta vårt samtal

Awesome!

Completion rate improved to 3.57

bookCommit-meddelanden

Svep för att visa menyn

Varför commit-meddelanden är viktiga

Commit-meddelanden är avgörande för att förstå ett projekts historik. Tydliga och meningsfulla meddelanden hjälper samarbetspartners, framtida utvecklare och dig själv att förstå syftet och sammanhanget för varje ändring. En välstrukturerad commit-historik förbättrar samarbetet, förenklar felsökning och gör det enklare att spåra specifika ändringar i projektets tidslinje.

Anatomien av ett bra commit-meddelande

1. Kortfattat och tydligt

Ett commit-meddelande ska vara kortfattat och direkt. Det ska tydligt förmedla syftet med commiten i en enda rad. Undvik tvetydighet och ge tillräcklig information för att förstå ändringen utan att behöva titta på själva koden.

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

2. Separera ämne från brödtext

Om mer information behövs, separera ämnet från brödtexten i commit-meddelandet med en tom rad. Ämnet ska sammanfatta ändringen, och brödtexten kan ge ytterligare sammanhang, skäl till ändringen och annan relevant information.

Låt oss titta på ett exempel på ett sådant commit-meddelande:

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 detta fall, kör kommandot git commit utan flaggan -m:

Den förvalda textredigeraren för Git kommer att öppnas, där du kan skriva ett detaljerat commit-meddelande. Du ska sedan spara det och avsluta textredigeraren på lämpligt sätt.

Låt oss göra ytterligare en commit i vårt arkiv:

Här är kommandot som används för att ändra textfilen:

Commit-meddelandet enligt följande:

Om du inte kan redigera filen, tryck på i-tangenten. Detta säkerställer att du går in i redigeringsläget. För att spara ändringar och avsluta Vim, tryck på Escape-tangenten och två stora Z-bokstäver.

Note
Notera

Om du har en annan standardtextredigerare för terminalen (än Vim) och stöter på några svårigheter, kan du enkelt hitta hur du sparar ändringar och avslutar den på internet.

3. Använd imperativ form

Skriv commit-meddelanden i imperativ form, vilket ger en tydlig riktning för ändringen. Börja ämnesraden med ett verb, såsom "Fix", "Add" eller "Update".

Bad: "Fixed the issue with the login form"
Good: "Fix issue with user authentication in login form"
Var allt tydligt?

Hur kan vi förbättra det?

Tack för dina kommentarer!

Avsnitt 1. Kapitel 10
some-alt