자주 쓰는 Git 설정 옵션

Git 설정이란

Git의 동작 대부분은 git config로 바꿀 수 있다. 개발자들이 즐겨 켜 두는 옵션 중에는 기본값이 불편해서 생기는 실수(의도치 않은 merge 커밋, 읽기 힘든 충돌 표시)를 한 줄로 막는 것이 많다.

git config --global <이름> <값>     # 설정 (~/.gitconfig에 저장)
git config --global --unset <이름>  # 해제
git config --list                   # 현재 설정 확인
git config --global --edit          # 설정 파일을 편집기로 열기

Git 2.46부터는 하위 명령 형식(git config list, git config get <이름>, git config set <이름> <값>, git config unset <이름>)도 쓸 수 있다. 위의 옛 형식도 그대로 동작한다.

설정 범위

같은 이름의 설정이 여러 곳에 있으면 좁은 범위가 이긴다.

git config --list --show-origin --show-scope로 각 값이 어느 파일·범위에서 왔는지 본다.

Pull과 Merge

pull.ff only와 pull.rebase true는 둘 다 의도치 않은 merge 커밋을 막는 용도다. 둘 중 하나만 쓴다. 함께 켜면 --ff-only가 우선해 rebase 설정은 의미가 없다.

Rebase

옛 커밋을 고치는 흐름은 이렇게 짧아진다.

git commit --fixup a1b2c3d   # 고칠 내용을 fixup 커밋으로
git rebase -i main           # autosquash가 켜져 있으면 자동으로 제자리에 합쳐짐

Push와 브랜치

Diff와 커밋

전역·환경별 설정

# ~/.gitconfig: 회사 폴더에서만 회사 이메일 쓰기
[includeIf "gitdir:~/work/"]
  path = ~/.gitconfig-work

커밋 작성자와 GitHub 기여 그래프

커밋에 찍히는 이름·이메일은 user.name, user.email에서 온다. --global은 ~/.gitconfig에, 옵션 없이 저장소 안에서 실행하면 그 저장소의 .git/config에 저장되고 저장소 설정이 우선한다. 현재 값은 git config --list --show-origin으로 어느 파일에서 왔는지까지 본다.

GitHub 프로필의 기여 그래프(잔디)는 커밋 작성자 이메일이 내 GitHub 계정에 등록된 이메일과 같을 때만 집계된다. 그래서 계정에서 옛 이메일을 지우면 그 이메일로 쓴 과거 커밋이 그래프에서 사라진다.

• 이메일을 바꿀 때는 옛 이메일을 지우지 말고 보조 이메일로 남겨 둔다. 가장 안전하다.
• 주소를 공개하고 싶지 않으면 GitHub가 주는 아이디@users.noreply.github.com 주소를 user.email로 쓴다.
• 이미 지웠다면 과거 커밋의 작성자를 다시 써야 한다. 이력 재작성이므로 되돌리기와 이력 다루기의 git filter-repo --mailmap을 참고한다.

명령에 별명 붙이기: alias

길게 치는 명령은 alias.<이름>으로 줄인다. ~/.gitconfig의 [alias] 절에 직접 적어도 된다.

git config --global alias.st status
git config --global alias.l "log --graph --abbrev-commit --pretty=format:'%C(red)%h%C(reset) -%C(yellow)%d%C(reset) %s %C(green)(%cr) %C(bold blue)<%an>%C(reset)'"

이제 git l이 브랜치 그래프와 해시·참조·메시지·상대 시각·작성자를 한 줄씩 색을 입혀 보여 준다.

셸 alias와 함수 패턴

alias 값이 !로 시작하면 git 하위 명령이 아니라 셸 명령으로 실행된다. 파이프와 명령 치환을 쓸 수 있고, 저장소 최상위 폴더에서 실행된다.

[alias]
  s    = status -sb
  cur  = branch --show-current                         # 현재 브랜치 이름
  # 인자가 필요하면 함수를 선언하고 바로 부른다: git sync upstream
  sync = "!f() { git fetch \"$1\" && git reset --hard \"$1/$(git branch --show-current)\"; }; f"
  # fzf로 고르기: 브랜치를 골라 이동, 파일을 여러 개 골라 add
  sw   = "!git switch $(git branch | grep -v '^\\*' | fzf | awk '{print $1}')"
  a    = "!git add $(git status -s | fzf -m | awk '{print $2}')"
  aliases = "!git config --get-regexp '^alias\\.' | sed 's/^alias\\.//'"

reset --hard나 브랜치 삭제처럼 되돌릴 수 없는 명령을 alias로 감싸면 실수가 한 단어로 줄어든다. 위험한 alias는 확인 단계를 넣거나 만들지 않는다.

서브모듈을 쓰면 submodule.recurse true, status.submoduleSummary true, diff.submodule log도 자주 언급된다.

정리

• 처음 켤 만한 것: pull.ff only(또는 pull.rebase true), merge.conflictstyle zdiff3, rebase.autosquash true, diff.algorithm histogram.
• 여러 계정을 쓰면 includeIf와 user.useConfigOnly로 커밋 이메일 실수를 막는다.
• 설정은 기기마다 따로라서, ~/.gitconfig를 dotfiles로 관리하면 여러 기기에서 같은 환경을 유지할 수 있다.

관련 노트: 기본 명령과 파일 상태, 브랜치 병합, 되돌리기와 이력 다루기, stash, worktree, clean