GitHub 기본 브랜치명을 master에서 main으로 변경하며 배운 점
최근 오픈소스 생태계에서는 주종 관계를 연상시키는 master라는 용어 대신 main을 기본 브랜치명으로 쓰도록 권장합니다. 저 또한 새 저장소를 만들 때마다 이 설정을 적용하려 했으나, 생각보다 과정이 매끄럽지 않았습니다.
오늘은 브랜치명을 바꾸며 겪은 시행착오와 거기서 얻은 문제 해결의 관점을 정리해 봅니다.
왜 자꾸 master로 생성될까?
깃허브 저장소를 만들 때마다 기본 브랜치가 main이 아닌 master로 잡히는 문제가 있었습니다. 해결하려고 몇 가지를 시도해 봤습니다.
1. 로컬 Git 버전 확인
Git은 2.28 버전부터 기본 브랜치 이름을 설정하는 기능을 지원합니다. 제 로컬 버전을 확인해 보니 이미 그보다 높았는데도 새 저장소를 만들면 여전히 master가 기본으로 잡혔습니다.
2. 로컬 브랜치 이름 변경 시도
로컬에서 git branch -m master main 명령어로 이름을 바꿔 봤지만 이 변경은 깃허브 원격 저장소에 자동으로 반영되지 않았습니다.
정답은 설계도 안에 있었다
구글링으로 여러 명령어를 시도해 봐도 명확한 해결책이 나오지 않았습니다. 결국 깃허브 페이지의 설정(Settings)을 직접 살펴보기로 했습니다.
GitHub 전체 설정 변경하기
무턱대고 검색창을 뒤지기보다 깃허브가 제공하는 기능을 하나씩 뜯어보니, Repositories 섹션에서 답을 찾을 수 있었습니다.
- GitHub 프로필 클릭 -> Settings 진입
- 왼쪽 메뉴의 Repositories 클릭
- Repository default branch 항목에서
master로 되어 있던 기본값을main으로 수정
이렇게 바꾸고 나니 이후 만드는 저장소는 모두 기본 브랜치가 main으로 잡혔습니다.
구글링보다 중요한 건 시스템 탐색
이번 트러블슈팅에서는 기술 지식 말고도 중요한 태도를 하나 배웠습니다.
- 무분별한 구글링의 함정 — 검색 결과에 나오는 수많은 명령어를 복사해 붙여넣다 보면, 정작 내가 쓰는 프로그램이 제공하는 직관적인 해결법을 놓치기 쉽습니다.
- 도구 안에서 먼저 찾기 — 문제가 생기면 외부에서 답을 구하기 전에, 내가 쓰는 도구(GitHub, IDE 등)의 설정이나 공식 문서부터 꼼꼼히 살펴보는 편이 훨씬 빠르고 정확했습니다.
기술은 계속 변하고 설정값도 바뀝니다. 명령어 한 줄을 외우기보다 서비스의 구조를 이해하고 설정을 관리하는 능력이 개발자에게 훨씬 중요하다는 걸 새삼 느꼈습니다.
팁: 이미 만든 저장소의 브랜치명을 바꾸려면?
이미 master로 만든 저장소라면, 해당 저장소의 Settings > Branches 메뉴에서 연필 모양 아이콘을 눌러 이름을 바꿀 수 있습니다. 바꾼 뒤에는 로컬에서도 따로 동기화 작업을 해줘야 하니 주의하세요!