Git 브랜치·참조 이름 검사기

Git 브랜치·참조 이름 검사기 사용 가이드

Git은 브랜치와 태그 이름에 쓸 수 없는 글자와 모양을 정해 두어, 규칙에 어긋난 이름은 만들 때 오류가 나거나 다른 도구에서 문제를 일으킵니다. 자동화 스크립트로 이슈 제목에서 브랜치 이름을 만들 때 특히 자주 걸립니다.

이 도구는 이름을 한 줄에 하나씩 받아 git check-ref-format의 규칙대로 검사합니다. 공백과 제어 문자, ~ ^ : ? * [ \ 기호, .. 과 @{ 조합, 앞뒤의 / 나 // 같은 빈 구간, . 으로 끝나는 이름, @ 한 글자를 찾아냅니다.

/로 나뉜 구간마다도 확인해 a/.hidden처럼 . 으로 시작하는 구간이나 main.lock/x처럼 .lock으로 끝나는 구간을 알려 줍니다. 결과는 '사용 가능/사용 불가, 이름, 이유'가 탭으로 나뉘어 스프레드시트에서 정리하기 좋습니다.

사용 방법

1. 1'입력' 칸에 검사할 브랜치·태그 이름을 한 줄에 하나씩 넣습니다.
2. 2'실행'을 누르면 줄마다 사용 가능 여부와 문제 이유가 나옵니다.
3. 3사용 불가로 나온 이름은 이유에 적힌 글자나 모양을 고쳐 다시 검사합니다.

feature/markdown-tools
bad..branch
refs/heads/main.lock/x
a/.hidden
x[y
feat//x

사용 가능	feature/markdown-tools
사용 불가	bad..branch	".." 포함
사용 불가	refs/heads/main.lock/x	".lock"으로 끝나는 구간
사용 불가	a/.hidden	"."로 시작하는 구간
사용 불가	x[y	공백·제어 문자 또는 ~ ^ : ? * [ \ 포함
사용 불가	feat//x	빈 구간(앞뒤의 / 또는 //)

이럴 때 쓰면 좋아요

• 이슈 제목으로 브랜치 이름을 자동 생성하는 스크립트의 결과를 점검할 때
• CI에서 태그 이름 규칙 위반으로 배포가 실패한 원인을 찾을 때
• 팀 브랜치 명명 규칙 문서에 넣을 예시가 유효한지 확인할 때
• 다른 시스템에서 가져온 이름 목록을 Git 참조로 쓸 수 있는지 볼 때

문제가 생겼을 때

활용 팁

• 이 도구는 이름 모양만 검사하고 실제 저장소에 같은 이름의 브랜치가 있는지는 확인하지 않습니다. 중복은 git branch --list로 확인하세요.
• feature와 feature/login을 함께 만들 수는 없습니다. 같은 이름이 파일이자 폴더가 되기 때문이니 접두어 이름을 따로 브랜치로 쓰지 마세요.

자주 묻는 질문