git pull 충돌 줄이기: --rebase와 --ff-only 선택 기준 팀 실무 가이드

git pull 충돌 줄이기: --rebase와 --ff-only 선택 기준 팀 실무 가이드

git pull은 fetch와 merge(rebase)를 합친 명령이다. 팀 정책 없이 쓰면 히스토리가 복잡해지고 충돌 복구 비용이 늘어난다.

공식 Git 로고 (출처: git-scm.com)

기본 사용법

git pull origin main
git pull --rebase origin main

자주 쓰는 옵션 4가지

항목	의미	언제 쓰는지(실무 상황)
--rebase	가져온 후 리베이스로 재정렬	개인 feature 브랜치 히스토리를 깔끔히 유지할 때
--ff-only	fast-forward만 허용	예상치 못한 merge commit 생성을 막을 때
--no-rebase	항상 merge 방식 사용	팀이 merge 중심 정책일 때
--autostash	로컬 변경을 임시 보관 후 pull	작업 중 동기화가 급히 필요할 때

문제 상황

상황: pull 이후 의도치 않은 merge commit이 쌓여 로그가 복잡해진다.
원인: 로컬 기본 pull 전략을 설정하지 않았다.
해결: git config pull.rebase true 또는 pull.ff only로 팀 정책을 명시한다.
예방 팁: 저장소 README에 pull 전략과 예외 상황을 함께 문서화한다.

참고/출처

공식 문서: git-pull manual
공식 문서: git-config (pull.rebase, pull.ff)
신뢰 자료: GitHub Docs - Getting changes from a remote repository