Het wisselen van de standaardbranch in je GitHub-repository is meestal eenvoudig, maar het kan wat verwarrend zijn als je niet gewend bent aan de interface of Git-commando’s. Soms verandert de standaardbranchinstelling niet direct na een lokale naamswijziging of het pushen van de wijziging – en dan wordt het lastig, vooral als iedereen vanuit de verkeerde branch werkt. Hopelijk verduidelijkt dit het proces, zodat je niet met meerdere bronnen hoeft te jongleren of verdwaalt in de instellingen. In principe wil je dat de standaardbranch het nieuwe doel is voor pull requests, en het helpt om alles overzichtelijk te houden, vooral als je van master naar main gaat of overschakelt naar een nieuwe hoofdlijn.
Hoe verander ik de standaardbranch op GitHub?
Methode 1: Standaardbranch wijzigen via de GitHub-website
Het is meestal het makkelijkst om het rechtstreeks via de webinterface van GitHub te doen. Dit is handig als je er zeker van wilt zijn dat iedereen vanaf dezelfde pagina begint en niet de verkeerde branch gebruikt. Dit geldt ook als je de branch al lokaal hebt hernoemd en gepusht, maar de standaardinstelling nog steeds naar de oude verwijst.
- Open uw repo op GitHub.
- Klik op Instellingen in de bovenste menubalk. Deze bevindt zich meestal aan de rechterkant, na het tabblad Inzichten.
- Navigeer naar Vestigingen in het menu aan de linkerzijde.
- Klik onder Standaardtak op het potlood-/bewerkpictogram.
- Selecteer de nieuwe branch (zoals main ) uit de dropdown. Als deze niet verschijnt, controleer dan of je hem correct hebt gepusht.
- Klik op Bijwerken en bevestig.
De standaardbranch van je repository verwijst nu naar de door jou gekozen branch. In sommige configuraties kan het even duren voordat dit is doorgevoerd, of moet je de pagina mogelijk vernieuwen. Als dat niet helpt, kun je het volgende doen:
Methode 2: Standaardbranch wijzigen met Git-opdrachten
Als je in de terminal werkt en er de voorkeur aan geeft om van daaruit te pushen, kun je branches lokaal hernoemen/verplaatsen en die wijzigingen pushen. Onthoud wel dat het hierbij gaat om het updaten van je lokale branch en het pushen ervan, en vervolgens de standaardinstellingen op de GitHub-website aanpassen. Het is een beetje vreemd, maar zo werkt GitHub nu eenmaal.
- Open uw terminal (of PowerShell, wat u ook gewend bent).
- Navigeer naar uw repo-map, zoals `
cd path/to/your/repo
`. - Als u een bestaande branch wilt hernoemen
master
naar bijvoorbeeldmain
, doet u het volgende:
git branch -m master main
Hiermee wordt de branch lokaal hernoemd. Push vervolgens de hernoemde branch en stel deze upstream in:
- Push de nieuwe branch naar GitHub en stel deze in als upstream:
git push -u origin main
- Verwijder nu de oude branch van de remote om verwarring te voorkomen, maar alleen als u zeker weet:
git push origin --delete master
Let op: Zorg ervoor dat je de standaardbranchinstelling al op GitHub zelf hebt aangepast, want dit regelt alleen je lokale kant. Soms wordt de standaardinstelling op afstand niet direct bijgewerkt, dus ververs de pagina na het pushen. Ga vervolgens terug naar de instellingen en controleer of de standaardbranch naar main verwijst.
Waarom zou je de standaardbranch veranderen?
Goede vraag — als je je afvraagt waarom iemand van master naar main zou overstappen, is dat vooral om inclusievere taal te gebruiken. Als je je repository reorganiseert of overstapt naar een nieuwe branch als primaire dev-lijn, zorgt het instellen van deze standaard ervoor dat nieuwe pull-requests precies op de juiste plek terechtkomen. Bovendien is het gewoon overzichtelijker en minder verwarrend voor nieuwe bijdragers.
Veelgestelde vragen
Je moet het lokaal hernoemen met git branch -m master main
, pushen met git push -u origin main
, de oude remote branch verwijderen met git push origin --delete master
en vervolgens de standaardbranch in de GitHub-instellingen bijwerken. Het is een beetje een omweg, maar het werkt.
Nee. De oude branch blijft staan, tenzij je hem handmatig verwijdert. Dus als je een schone start wilt, vergeet dan niet om hem daarna te verwijderen.
Jazeker. Pull-requests en klonen worden standaard uitgevoerd in de hoofdbranch, dus geef je team een waarschuwing voordat je het omdraait, zodat iedereen op één lijn zit.
Absoluut. Je gaat gewoon weer naar de GitHub-instellingen en kiest de oude branch als standaard. Geen probleem.
Afronding
Het wijzigen van je standaardbranch is niet super ingewikkeld als je het eenmaal onder de knie hebt. Op het web is het met een paar klikken gedaan, en via Git-commando’s is het wat praktischer, maar nog steeds beheersbaar. Onthoud: ververs na alles je GitHub-pagina om de nieuwste instellingen te zien en controleer nogmaals of je pull-requests op de juiste branch zijn gericht. Hopelijk bespaart dit iemand een hoop hoofdpijn – ik heb hier met meerdere instellingen gewerkt.
Samenvatting
- Controleer of de naam van uw lokale vestiging correct is gewijzigd en of deze correct is gepusht.
- Werk de standaardbranch op GitHub bij via Instellingen > Branches.
- Verwijder indien nodig oude takken, maar wees voorzichtig.
- Stel uw team op de hoogte van wijzigingen als u samenwerkt.