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