← 전체로 돌아가기
스킬 git

Git 기본 브랜치 변경

Git 기본 브랜치를 master에서 main으로 변경하는 방법

gitbranchmainmasterconfig

새로운 Git 레포 만들 때 기본 브랜치를 master 대신 main으로 설정하고 싶지? 아니면 기존 레포의 master 브랜치 이름을 main으로 바꾸고 싶을 때 유용해. 간단한 설정과 명령어로 해결할 수 있어.

1. 새 레포 기본 브랜치 설정

전역 설정으로 앞으로 만들 모든 새 레포의 기본 브랜치를 main으로 지정할 수 있어.

git config --global init.defaultBranch main

2. 기존 레포 브랜치 이름 변경

이미 있는 레포의 master 브랜치를 main으로 바꾸려면 다음 단계를 따르면 돼.

  • 로컬 master 브랜치를 main으로 이름 변경:
git branch -M main
  • 변경된 main 브랜치를 원격에 푸시하고 추적 설정:
git push -u origin main

  • 원격 저장소 (GitHub, GitLab 등) 설정에서 기본 브랜치를 main으로 변경해야 함.

  • (선택) 기존 master 브랜치 원격에서 삭제:

git push origin --delete master

여기서 배울 것

  1. `git config --global init.defaultBranch`로 새 레포의 기본 브랜치를 설정할 수 있음
  2. `git branch -M`으로 로컬 브랜치 이름을 변경할 수 있음
  3. `git push -u origin`으로 새 기본 브랜치를 원격에 푸시하고 추적 설정함
  4. 원격 저장소 UI에서 기본 브랜치 변경이 필요함
원본 파일 보기 (.claude/skills/tn-git-default-branch-change/SKILL.md) 
---
name: Git 기본 브랜치 변경
description: Use when the user wants to change the default branch name in Git, for example, from 'master' to 'main', for new or existing repositories.
version: 1.0.0
source: /home/son/prj/resume/backup_notes_260317/notion/Tech Note/git master branch change 192eaab0bec14f6c96581ece866186df.md
---

# git master branch change

[https://stackoverflow.com/questions/67543278/git-how-to-change-default-branch-for-everything-i-do](https://stackoverflow.com/questions/67543278/git-how-to-change-default-branch-for-everything-i-do)