30초 요약
Git을 처음 설치했으면 커밋하기 전에 아래 네 가지를 전역(--global)으로 정해 둔다.
git config --global user.name "이름"git config --global user.email "이메일"git config --global init.defaultBranch maingit config --global core.autocrlf input # Windows는 truegit config --global core.quotePath false # 한글 등 비ASCII 파일명을 그대로 보고 싶을 때--global은 지금 로그인한 사용자 전체에 적용되고, 저장소 하나만 다르게 하고 싶으면 그 저장소 안에서 --global 없이 같은 키를 다시 설정해 덮어쓴다.
증상/목표
Git을 설치만 하고 아무 설정도 하지 않은 상태에서 저장소를 만들면 다음이 기본값 그대로 남는다.
- 커밋 작성자 정보(
user.name,user.email)가 비어 있다 - 새 저장소의 기본 브랜치 이름이
master다 - 텍스트 파일의 줄바꿈을 커밋·체크아웃 시 바꾸지 않는다(
core.autocrlf미설정) - 파일 이름에 한글 등 비ASCII 문자가 있으면
git status·git diff같은 명령 출력에서 이스케이프된 형태로 나온다(core.quotePath기본값true)
이 글은 이 네 가지를 각각 무엇으로, 왜 바꾸는지와, 바꾸기 전후 git status 출력이 어떻게 달라지는지를 정리한다.
원인
사용자 정보: Git 공식 문서는 저장소를 쓰기 전에 user.name, user.email을 --global로 한 번만 설정해 두면 이후 시스템의 모든 저장소에서 이 정보를 커밋 작성자로 쓴다고 설명한다. 설정하지 않으면 커밋마다 작성자가 비거나 환경마다 다르게 추정된 값이 들어갈 수 있다.
기본 브랜치 이름: git init의 새 저장소 브랜치 이름은 init.defaultBranch로 바꿀 수 있는데, 공식 문서는 이 값을 “currently master, but this will change to main when Git 3.0 is released”라고 밝힌다. 즉 지금 Git 자체의 기본값은 아직 master이고, 앞으로 나올 Git 3.0에서 main으로 바뀔 예정이다. 이 값을 미리 정해 두지 않으면, Git 버전을 올렸을 때 새로 만드는 저장소의 기본 브랜치 이름이 예고 없이 달라질 수 있다.
줄바꿈 변환: core.autocrlf는 공식 문서에서 “Setting this variable to true is the same as setting the text attribute to auto on all files and core.eol to crlf. Set to true if you want to have CRLF line endings in your working directory and the repository has LF line endings. This variable can be set to input, in which case no output conversion is performed.”라고 설명한다. 즉 true는 저장소는 LF로 두고 작업 폴더에서는 CRLF를 쓰고 싶을 때(전형적으로 Windows) 쓰는 값이고, input은 체크아웃 시 변환을 하지 않는 값이다. 이 값을 정하지 않으면 파일에 섞여 들어간 줄바꿈이 그대로 커밋돼 나중에 diff가 줄바꿈 문자 때문에 지저분해진다.
한글 파일명 표시: core.quotePath는 공식 문서에서 ls-files, diff처럼 경로를 출력하는 명령이 “unusual” 문자(0x80보다 큰 바이트 포함)를 큰따옴표로 묶고 백슬래시로 이스케이프한다고 설명하며, 기본값은 true다. 한글 파일명은 UTF-8로 인코딩하면 모든 바이트가 0x80보다 크기 때문에, 기본값 그대로면 git status 같은 명령에서 한글 파일명이 항상 이스케이프된 8진수 문자열로 보인다. 파일명 자체가 깨진 것이 아니라 표시 방식 때문이다.
해결 방법
1. 사용자 정보 설정 (user.name, user.email)
git config --global user.name "Hong Gildong"git config --global user.email "hong@example.com"git config --global user.name으로 값을 다시 확인할 수 있고, 저장소 하나만 다른 이메일을 쓰고 싶으면 그 저장소 폴더 안에서 --global 없이 git config user.email "다른메일"을 실행해 지역 설정으로 덮어쓴다.
2. 기본 브랜치 이름 설정 (init.defaultBranch)
git config --global init.defaultBranch main이 설정 이후 git init으로 새로 만드는 저장소부터 기본 브랜치 이름이 main이 된다. 이미 만들어 둔 저장소의 브랜치 이름은 바뀌지 않으므로, 바꾸려면 그 저장소 안에서 git branch -m master main을 따로 실행한다.
3. 줄바꿈 변환 설정 (core.autocrlf)
git config --global core.autocrlf input # macOS·Linuxgit config --global core.autocrlf true # WindowsmacOS·Linux에서는 작업 폴더에 CRLF가 필요 없으므로 input을 쓴다. input은 커밋할 때 CRLF가 섞여 있으면 LF로 정리하지만, 체크아웃할 때는 변환하지 않는다. Windows에서 true를 쓰면 저장소에는 LF로 저장하면서 체크아웃한 작업 폴더 파일은 CRLF로 바꿔 준다. Windows용 Git 설치 프로그램은 설치 과정 중 “Configuring the line ending conversions” 화면에서 이 값(true/input/false)을 직접 고르게 한다.
core.autocrlf는 이 값을 설정한 사람 개인의 전역 기본값일 뿐이다. 같은 저장소를 여러 사람이 함께 쓰는 팀 환경에서는 사람마다 이 값이 다를 수 있어 줄바꿈이 다시 섞일 수 있다. Git 공식 문서(gitattributes)는 이런 경우 저장소 루트에 .gitattributes 파일을 두고 * text=auto를 커밋해 텍스트 파일의 줄바꿈을 저장소 단위로 정규화하라고 안내한다. .gitattributes는 저장소에 커밋되는 파일이라, 기여자 개인의 core.autocrlf 설정과 상관없이 모두에게 같은 규칙이 적용된다.
4. 한글 파일명 표시 설정 (core.quotePath)
git config --global core.quotePath false기본값(true)과 false일 때 git status 출력이 어떻게 달라지는지는 아래 그림과 같다.
커밋에 서명까지 붙이려면 Git 커밋 서명을 SSH 키로 설정하기를 이어서 본다.
확인
아래 실행 결과는 러너 안 임시 $HOME에서 GIT_CONFIG_NOSYSTEM=1로 시스템 설정을 끄고 verify.sh를 돌린 run.log에서 그대로 옮긴 것이다. run.log가 전후 git status 출력을 직접 찍어 비교한 설정은 core.quotePath뿐이다. user.name·user.email·init.defaultBranch·core.autocrlf는 같은 run.log에서 설정값·브랜치 이름·체크아웃/커밋된 파일 내용을 비교하는 판정(check)으로 확인했고, 아래처럼 명령 출력 자체를 옮기지는 않는다.
한글.txt 파일에 대한 core.quotePath 기본값(true) 상태의 실행 결과:
On branch main
No commits yet
Untracked files: (use "git add <file>..." to include in what will be committed) "\355\225\234\352\270\200.txt"
nothing added to commit but untracked files present (use "git add" to track)core.quotePath false로 바꾼 뒤 같은 명령의 실행 결과:
On branch main
No commits yet
Untracked files: (use "git add <file>..." to include in what will be committed) 한글.txt
nothing added to commit but untracked files present (use "git add" to track)전체 실행 로그는 아래에서 확인할 수 있다.
검증 환경 3항목
| OS | Ubuntu 24.04.5 |
|---|---|
| Git | 2.55.0 |
| 실행 날짜 | 2026-09-25 |
== 1. 사용자 정보: user.name, user.email == [PASS] user.name이 전역 설정에 저장됨 [PASS] user.email이 전역 설정에 저장됨 [PASS] 전역 설정 파일이 $HOME/.gitconfig에 생김 == 2. 기본 브랜치 이름: init.defaultBranch == [PASS] init.defaultBranch을 설정하기 전에는 새 저장소의 기본 브랜치 이름이 master [PASS] init.defaultBranch=main 설정 후 새로 만든 저장소의 기본 브랜치가 main [PASS] init.defaultBranch은 이미 만든 저장소(repo1)의 브랜치 이름은 바꾸지 않는다 == 3. 줄바꿈 변환: core.autocrlf == [PASS] core.autocrlf를 설정하기 전에는 LF로 커밋한 파일이 그대로 LF [PASS] core.autocrlf=true로 체크아웃하면 저장소의 LF가 작업 폴더에서 CRLF로 바뀐다 warning: in the working copy of 'crlf.txt', CRLF will be replaced by LF the next time Git touches it [PASS] core.autocrlf=input이면 커밋되는 내용은 CRLF가 LF로 정리된다 [PASS] core.autocrlf=input은 체크아웃은 건드리지 않아 작업 폴더의 crlf.txt는 CRLF 그대로 == 4. 한글 파일명 표시: core.quotePath == --- core.quotePath 기본값(true) 상태의 git status --- On branch main No commits yet Untracked files: (use "git add <file>..." to include in what will be committed) "\355\225\234\352\270\200.txt" nothing added to commit but untracked files present (use "git add" to track) [PASS] core.quotePath 기본값(true)에서는 한글 파일명이 큰따옴표로 묶여 나온다 --- core.quotePath=false 상태의 git status --- On branch main No commits yet Untracked files: (use "git add <file>..." to include in what will be committed) 한글.txt nothing added to commit but untracked files present (use "git add" to track) [PASS] core.quotePath=false면 한글 파일명이 그대로(UTF-8) 나온다 [PASS] core.quotePath=false 출력에는 큰따옴표 이스케이프가 없다 == 5. 최종 전역 설정 확인 == [PASS] 전역 설정에 네 항목이 모두 남아 있다 (user.name/email, init.defaultBranch, core.autocrlf, core.quotePath)
주의
--global설정은 지금 로그인한 사용자 전체에 적용된다. 회사 계정과 개인 계정처럼 저장소별로 다른user.email을 써야 하면, 그 저장소 폴더 안에서--global없이 다시 설정하거나 Git의 조건부 include(includeIf) 기능으로 폴더별 설정 파일을 분리한다.init.defaultBranch는 그 값을 설정한 이후에git init한 저장소에만 적용된다. 이미 있는 저장소의 브랜치 이름은 그대로 남는다.core.autocrlf=true는 작업 폴더에 CRLF가 필요할 때(전형적으로 Windows) 쓰는 값이다. macOS·Linux에서 무심코true로 두면 텍스트 파일의 작업 폴더 사본에 불필요한 CRLF가 섞여 들어갈 수 있다.core.quotePath false는 터미널·에디터가 UTF-8을 제대로 표시할 수 있을 때 도움이 된다. 터미널 자체의 인코딩 설정이 다른 문제(예: HTML 페이지의 한글 깨짐)는 이 설정과 별개다.- macOS에서 한글 파일명이 자모가 풀어진 형태(예: 한글이 아니라 낱자로 분리된 모양)로 보이고, 파일을 바꾸지 않았는데도
git status가 계속 변경된 파일로 잡는다면core.quotePath와는 다른 문제다. macOS가 파일명을 유니코드 분해형(NFD)으로 저장해서 생기며, Git 공식 문서(git-config)는core.precomposeUnicode를 macOS 전용 설정으로 설명한다:true로 두면 macOS가 분해한 파일명을 Git이 되돌려 조합형으로 다룬다. 이 글은 이 항목을 macOS 환경에서 실행으로 확인하지 않았다.
자주 묻는 질문
지금까지 설정한 값을 한 번에 보려면?
git config --global --list로 전역 설정을 모두 보거나, git config --global --edit으로 ~/.gitconfig 파일을 편집기로 직접 연다.
init.defaultBranch를 main으로 하면 GitHub 같은 호스팅 서비스와 항상 맞나?
Git 자체의 기본값은 아직 master이고 앞으로 Git 3.0에서 main으로 바뀔 예정이라고 공식 문서에 나와 있을 뿐이다. 호스팅 서비스의 기본값은 서비스마다 따로 정한다. GitHub는 2020년 10월부터 새로 만드는 저장소의 기본 브랜치 이름을 main으로 바꿨다고 공식 발표했으므로, init.defaultBranch main으로 맞춰 두면 지금 GitHub에 새로 만드는 저장소와는 이름이 일치한다. 다만 다른 호스팅 서비스나 사내 Git 서버의 기본값까지 보장하지는 않으므로, 팀에서 쓰는 이름을 init.defaultBranch로 미리 맞춰 두면 저장소마다 브랜치 이름을 다시 바꾸는 수고를 던다.
core.autocrlf를 나중에 바꾸면 이미 커밋된 내용도 바뀌나?
아니다. 이미 저장소에 커밋된 내용은 그대로 남고, 설정을 바꾼 뒤에 새로 체크아웃하거나 커밋하는 파일부터 적용된다.
한글 파일명이 여전히 물음표나 깨진 글자로 보인다면?
core.quotePath false는 Git이 경로를 이스케이프하지 않고 그대로 출력하게 할 뿐이다. 그 출력을 받는 터미널이나 파일 시스템 인코딩이 UTF-8이 아니면 여전히 깨져 보일 수 있다.
참고 자료
- git-scm.com/book/en/v2/Getting-Started-First-Time-Git-Setup
- git-scm.com/docs/git-config
- git-scm.com/docs/git-config
- git-scm.com/docs/git-config
- git-scm.com/docs/git-init
- git-scm.com/docs/gitattributes
- github.com/git-for-windows/build-extra/blob/main/installer/install.iss
- github.blog/changelog/2020-10-01-the-default-branch-for-newly-created-repositories-is-now-main/