[깃초] 5부 - 깃 협업시 주로 발생하는 문제

깃 협업 시 발생하는 문제 상황과 해결 방법

지금까지 깃 플로우 전략과 그 활용법을 알아보았습니다. 하지만 실무에서 협업할 때 깃을 사용하다 보면 다양한 문제가 발생할 수 있습니다. 이번 글에서는 협업 과정에서 자주 겪게 되는 대표적인 문제 상황과 이를 효과적으로 해결하는 방법에 대해 살펴보겠습니다.

 

1. 병합 충돌(Merge Conflict)

깃 협업 과정에서 가장 흔히 발생하는 문제는 바로 병합 충돌(Merge Conflict)입니다. 여러 명의 개발자가 동일한 파일을 동시에 수정하면 깃이 자동으로 병합할 수 없을 때 충돌이 발생합니다.

원인

• 같은 파일의 같은 부분을 서로 다르게 수정했을 때
• 동일 브랜치에서 장기간 독립적으로 작업한 후 병합할 때

해결 방법

• 충돌된 파일을 직접 열어 충돌 마커(<<<<<<<, =======, >>>>>>>)로 표시된 부분을 확인하고, 원하는 코드만 남기고 정리합니다.
• 충돌 해결 후 파일을 스테이징(git add)하고 커밋하여 병합을 완료합니다.

$ git merge feature/user-profile
Auto-merging src/components/User.js
CONFLICT (content): Merge conflict in src/components/User.js

# 충돌 해결 후
$ git add src/components/User.js
$ git commit -m "fix: 유저 프로필 충돌 해결"

예방 방법

• 주기적으로 메인 브랜치에서 변경사항을 가져와 최신 상태를 유지(git pull)
• 작은 단위로 자주 커밋하고, 브랜치가 너무 오랫동안 격리되지 않게 관리

 

2. 잘못된 커밋 되돌리기

실수로 잘못된 내용을 커밋했을 때 이를 되돌리는 방법입니다.

원인

• 잘못된 파일 추가 또는 중요한 파일 누락
• 잘못된 커밋 메시지 작성

해결 방법

• 최근 커밋 수정: 메시지 수정이나 누락된 파일 추가는 다음 명령어를 사용합니다.

# 최근 커밋 메시지 수정
git commit --amend

# 최근 커밋에 파일 추가
git add missing-file.js
git commit --amend --no-edit

• 이전 커밋 되돌리기: 커밋을 되돌리려면 다음 명령어를 사용합니다.

# 특정 커밋 되돌리기
git revert <commit_hash>

주의점

• 이미 원격 저장소에 올라간 커밋은 강제로 삭제하지 않고 git revert를 이용하여 안전하게 변경사항을 되돌리는 것이 좋습니다.

 

3. 브랜치 관리 혼란

브랜치가 너무 많아져서 관리가 어렵거나 사용하지 않는 브랜치가 남아 있을 때 발생합니다.

해결 방법

• 브랜치 목록 확인 및 불필요한 브랜치 삭제

# 로컬 브랜치 목록 확인
git branch

# 사용하지 않는 브랜치 삭제
git branch -d feature/old-feature

# 원격 브랜치 삭제
git push origin --delete feature/old-feature

예방 방법

• 브랜치 이름 컨벤션을 명확하게 설정하고 주기적으로 브랜치를 정리합니다.
• 기능 구현 완료 후 병합된 브랜치는 빠르게 삭제하는 습관을 들입니다.

 

4. 코드 리뷰 지연 및 품질 저하

코드 리뷰가 지연되거나 제대로 이루어지지 않아 코드 품질이 저하되는 경우입니다.

해결 방법

• PR/MR 생성 시 리뷰어를 명확히 지정하고 리뷰 체크리스트를 활용합니다.
• 자동화된 CI/CD를 활용하여 코드 품질을 유지합니다.

예방 방법

• 작은 단위의 PR/MR을 자주 생성하여 리뷰 부담을 줄입니다.
• 리뷰 문화를 팀 내에서 적극적으로 독려하고, 코드 리뷰를 위한 정기 미팅을 마련합니다.

 

5. 잘못된 히스토리 관리

복잡하거나 불필요한 커밋 히스토리로 인해 관리가 어려워질 수 있습니다.

해결 방법

• 인터랙티브 리베이스(git rebase -i)를 사용하여 히스토리를 정리합니다.

# 최근 3개의 커밋을 정리
git rebase -i HEAD~3

예방 방법

• 명확한 커밋 메시지 컨벤션을 사용하고, 기능 구현 과정에서 의미 있는 단위로 커밋을 나누어 관리합니다.

 

결론

깃 협업 과정에서 발생하는 문제 상황들은 대부분 명확한 전략과 철저한 관리로 예방하거나 쉽게 해결할 수 있습니다. 팀원 간 지속적인 커뮤니케이션과 깃 사용법에 대한 공통의 이해가 있으면, 효과적인 협업 환경을 구축할 수 있습니다.

다음 글에서는 고급 깃 기능과 더 나은 협업을 위한 도구 활용법에 대해 알아보겠습니다.