좋은 Git 브랜치명을 만드는 5가지 규칙
브랜치명은 작업의 명함입니다. 잘 작성된 브랜치명 하나만 봐도 "이게 어떤 작업인지, 어떤 이슈에 연결돼 있는지, 누가 작업 중인지"가 한 번에 파악되어 코드 리뷰·CI/CD·릴리즈 노트 자동 생성까지 매끄럽게 흘러갑니다. 이 도구는 작업 유형(feature, fix, hotfix, release, chore, docs, refactor, test, style, perf), 선택적 스코프, 이슈 트래커 ID, 한국어 또는 영어 설명을 입력받아 git-flow·GitHub flow·Trunk-based development 세 가지 대표 컨벤션의 브랜치명을 동시에 생성합니다.
한글 설명을 입력해도 자동으로 영문 음역(transliteration)을 거쳐 kebab-case 슬러그로 변환됩니다. 예를 들어 "사용자 로그인 추가"는 "sayongja-rogin-chuga" 같은 로마자 슬러그로 바뀌고, 영문 설명을 직접 적으면 그대로 슬러그화됩니다. 브랜치명에는 공백·특수문자·대문자가 들어가지 않아야 하며, 끝에 마침표가 붙거나 / 로 끝나는 등 Git이 거부하는 패턴도 자동으로 정리됩니다.
3가지 대표 컨벤션 비교
git-flow는 feature/, release/, hotfix/, bugfix/ 같이 슬래시(/)로 구분하는 가장 전통적인 방식입니다. develop 브랜치에서 시작해 main으로 머지하는 흐름이 명확합니다. GitHub flow는 main만 유지하고 짧은 수명의 feature 브랜치만 사용합니다. 보통 username/feature-name 또는 issue-123-description 형태를 씁니다. Trunk-based development는 main에 자주 머지하는 방식으로 브랜치명은 더욱 짧고 명료해야 합니다(예: tbd/login-fix).
자주 묻는 질문 (FAQ)
Q. 브랜치명에 한글을 그대로 써도 되나요?
A. Git 자체는 UTF-8 한글 브랜치명을 허용하지만, CI 시스템이나 일부 IDE에서 인코딩 문제가 발생하므로 영문 슬러그로 변환하는 것이 표준입니다. 본 도구는 자동으로 변환해 줍니다.
Q. 이슈 ID를 브랜치명 앞에 두는 게 좋나요, 뒤에 두는 게 좋나요?
A. 정해진 답은 없지만, Jira·Linear처럼 자동 연결 봇이 있는 경우 type/ABC-123-description 형태(슬래시 뒤, 설명 앞)가 가장 잘 인식됩니다. GitHub Issues는 종종 issue-42-fix-login처럼 issue- 접두어를 씁니다.
Q. 브랜치명에 마침표(.) 두 개나 ..가 들어가면 안 되는 이유는?
A. Git 내부에서 ".."는 범위 지정 문법이라 reference 이름에는 사용할 수 없습니다. 끝에 .lock 으로 끝나도 안 되고, @, ~, ^, : 같은 문자도 금지됩니다. 본 도구는 모두 자동으로 제
상세 가이드
이 도구는 복잡한 작업을 간단하게 처리합니다. 정확한 결과를 얻기 위해 올바른 입력 값을 제공하세요. 모든 계산은 최신 알고리즘을 기반으로 수행되며, 결과의 정확성을 보장합니다. 모바일 기기를 포함한 모든 플랫폼에서 완벽하게 작동합니다.
주요 기능
빠른 처리 속도, 정확한 결과, 사용하기 쉬운 인터페이스, 안전한 데이터 처리, 광고 없는 경험을 제공합니다. 이 도구는 매일 수천 명의 사용자가 신뢰하는 온라인 유틸리티입니다.
사용 방법
필요한 정보를 입력란에 입력하고 실행 버튼을 클릭하면 즉시 결과를 확인할 수 있습니다. 설치나 회원가입이 필요 없으며, 완전히 무료로 사용할 수 있습니다. 여러 번 사용해도 추가 요금이 발생하지 않습니다.
자주 묻는 질문
이 도구는 얼마나 정확한가요? 매우 정확합니다. 최신 알고리즘과 검증된 수식을 사용하여 높은 정확도를 보장합니다.
비용이 드나요? 아니요, 완전히 무료입니다. 광고도 없습니다.
모바일에서 사용할 수 있나요? 네, 모든 기기에서 완벽하게 작동합니다.
거합니다.