SVN 병합 충돌, 5분 만에 해결하는 실전 팁 3가지

2026-06-27 · 테크 · 읽는데 5분

SVN을 사용하다 보면 "Conflict" 메시지를 마주할 때가 있습니다. 분명 제대로 커밋하려고 했는데 갑자기 이상한 .mine 파일과 .r### 파일들이 생겨 당황스러울 수 있는데요. 충돌이 발생하면 일단 당황하지 말고, 아래 3가지 팁만 기억하면 5분 안에 해결할 수 있습니다.


SVN 병합 충돌, 왜 발생하고 어떻게 확인할까

충돌은 두 명 이상의 개발자가 같은 파일의 같은 라인을 동시에 수정했을 때 발생합니다. 예를 들어, 개발자 A가 test.c 파일의 10번째 줄을 수정해 커밋했는데, 개발자 B가 저장소 업데이트 없이 같은 10번째 줄을 다른 내용으로 수정하고 커밋하려 하면 충돌이 일어납니다.

SVN 입장에서는 동일한 위치에 두 가지 서로 다른 내용이 있으므로, 어떤 것을 선택해야 할지 스스로 결정할 수 없습니다. 이때 SVN은 충돌이 난 파일을 특별한 상태로 표시하고, 다음과 같은 파일들을 자동으로 생성합니다.

  • test.c.mine: 내가 수정한 로컬 파일 내용
  • test.c.rOLDREV: 내가 수정하기 전에 받았던 원본 파일(Base 버전)
  • test.c.rNEWREV: 현재 저장소에 저장된 최신 파일(Head 버전)

또한 원본 파일(test.c) 안에는 <<<<<<< .mine과 >>>>>>> .r[Head] 마커가 삽입되어 충돌이 발생한 부분을 시각적으로 표시해 줍니다.


충돌 해결, 따라 하면 5분 안에 끝나는 3단계

충돌 해결 과정은 생각보다 복잡하지 않습니다. 아래 세 단계만 순서대로 따라 하면 됩니다.

1단계 충돌 파일 열어서 마커 확인하기

충돌이 발생한 파일을 텍스트 에디터로 열면 아래와 같은 마커를 볼 수 있습니다.

<<<<<<< .mine
(내가 수정한 내용)
=======
(저장소에 있는 최신 내용)
>>>>>>> .r100

이 마커는 <<<<<<< .mine부터 =======까지가 내가 수정한 코드이고, =======부터 >>>>>>> .r[버전번호]까지가 저장소에 이미 반영된 다른 개발자의 코드입니다. 즉, 두 코드가 충돌을 일으키고 있다는 뜻입니다.

2단계 최종 코드를 선택하고 마커 제거하기

충돌을 해결하는 방법은 세 가지입니다.

  • 내 코드를 유지하고 싶다면 상대방 코드를 삭제
  • 상대방 코드를 유지하고 싶다면 내 코드를 삭제
  • 두 코드를 적절히 합쳐서 새로운 코드를 작성

어느 쪽이 맞는지 판단이 어렵다면 저장소 로그 기능을 활용해 해당 코드를 누가 최종 커밋했는지 확인하는 것이 도움이 됩니다. 코드를 선택한 후에는 반드시 <<<<<<<, =======, >>>>>>> 같은 충돌 마커를 모두 삭제해야 합니다.

3단계 Resolve 실행하고 커밋하기

파일을 수동으로 수정한 후에는 SVN에 "충돌이 해결되었음"을 알려야 합니다. 이 작업은 Resolve 메뉴를 통해 수행합니다.

  • TortoiseSVN 사용자: 파일 우클릭 → TortoiseSVN → Resolve 선택
  • 명령어 사용자: svn resolved test.c 명령 실행

Resolve를 실행한다고 해서 파일 내용이 자동으로 수정되지는 않습니다. 단지 충돌이 해결되었음을 SVN에 알리고, 생성되었던 .mine, .rOLDREV, .rNEWREV 같은 부가 파일들이 제거됩니다. 이제 다시 커밋하면 내 변경 사항이 저장소의 최신 버전이 됩니다.


충돌을 줄이는 협업 습관

충돌 자체를 완전히 피할 수는 없지만, 아래 습관을 지키면 충돌 빈도를 확실히 줄일 수 있습니다.

  • 커밋 전 항상 최신 상태로 업데이트: 저장소에서 update를 받은 후에 커밋하는 습관을 들이세요.
  • 작업 단위를 작게 나누기: 큰 단위의 수정보다는 자주, 작게 커밋하는 것이 충돌 가능성을 낮춥니다.
  • 정기적인 코드 리뷰와 팀 소통: 팀원 간에 현재 작업 중인 파일과 범위를 공유하면 같은 파일을 동시에 수정하는 상황을 피할 수 있습니다.

Q. 충돌 해결 중 실수로 내 코드를 다 날렸어요. 복구할 방법이 없나요?

충돌 발생 시 생성되는 .mine 파일이 남아 있다면 그 파일을 열어 내 코드를 복구할 수 있습니다. 또한 svn diff 명령어로 변경 사항을 확인하는 방법도 있습니다.

Q. 충돌 파일이 많을 때는 하나씩 해결해야 하나요?

네, 각 파일마다 동일한 과정을 반복해야 합니다. 다만 TortoiseSVN 같은 GUI 도구를 사용하면 여러 파일의 충돌 상태를 한눈에 확인하고 순서대로 처리할 수 있어 시간을 절약할 수 있습니다.

Q. Resolve를 안 하고 커밋하면 어떻게 되나요?

Resolve 처리가 되지 않은 상태에서는 커밋이 거부됩니다. SVN이 충돌이 해결되지 않았다고 판단하기 때문에 반드시 Resolve 단계를 거쳐야 합니다.