Commit-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 lättare att spåra specifika ändringar i projektets tidslinje.
Uppbyggnad 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 ämnesrad från brödtext
Om mer information behövs, separera ämnesraden från brödtexten i commit-meddelandet med en tom rad. Ämnesraden ska sammanfatta ändringen, och brödtexten kan ge ytterligare sammanhang, orsaker till ändringen och annan relevant information.
Här är 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 du kommandot git commit utan flaggan -m:
git commit
Den förvalda textredigeraren för Git kommer att öppnas, där du kan skriva ett detaljerat commit-meddelande. Du ska sedan spara 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:
echo "Git is the most popular VCS in the world used by millions of developers since it allows efficient collaboration via committing, reverting and merging changes. Besides, Git is free and open source and can be easily installed on Windows, macOS, Linux and all Unix-based platforms." >> test.txt
Commit-meddelandet enligt följande:
Subject: "Add description of Git"
Body: "This commit introduces brief description
of Git and highlights its key features. It also
states the reasons for the widespread popularity
of Git."
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.
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 känsla av 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"
Tack för dina kommentarer!
Fråga AI
Fråga AI
Fråga vad du vill eller prova någon av de föreslagna frågorna för att starta vårt samtal