충돌은 어떻게 나타나나요
브랜치 머지나 리베이스처럼 두 히스토리를 합치는 작업에서 같은 줄이 서로 다르게 바뀌었으면 충돌이 발생합니다. 충돌이 나면 다음이 나타납니다.충돌 토스트
머지·리베이스(대화형 포함)·체리픽·되돌리기가 충돌로 끝나면 알림이 뜹니다. 문구는 앱 표기 그대로 “머지 충돌 — Working Copy 패널에서 충돌을 해결하세요.”입니다.
상단 배너
대부분의 경로에서는 워킹 카피 패널 맨 위에 머지 중(Merging) 배너가 생겨 남은 충돌 수와 함께 중단(Abort) / 계속(Continue)(머지일 때는 머지 커밋(Commit merge)) 버튼을 보여줍니다.
충돌 파일 섹션
스테이지 안됨(Unstaged) / 스테이지됨(Staged) 섹션 위에 별도의 충돌 파일(Conflicted) 섹션이 생겨 해결이 필요한 파일이 모입니다.
진행 중 작업 표시
작업 종류에 따라 배너가 머지 중(Merging) / Cherry-picking 중(Cherry-picking) / 되돌리는 중(Reverting) / Rebase 중(Rebasing) 으로 바뀝니다.
충돌을 유발할 수 있는 작업은 머지, 리베이스, 체리픽, 되돌리기(revert), 풀(merge 전략), 스태시 적용입니다. 배너와 토스트는 경로에 따라 다르게 나타나거나 아예 나타나지 않지만(아래 배너가 없는 두 경로 참고), 충돌 파일을 머지 에디터에서 해결하는 흐름은 어느 경로에서나 동일합니다.
머지 에디터로 해결하기
충돌 파일 섹션에서 파일을 클릭하면 메인 영역에 3분할 머지 에디터가 열립니다. 위쪽에 읽기 전용 내 것 (현재) 과 상대 것 (유입) 이 나란히, 아래쪽 전체 폭에 결과 (편집 가능) 패널이 놓입니다.
1
충돌 파일 열기
워킹 카피 패널의 충돌 파일(Conflicted) 섹션에서 파일을 클릭합니다. 에디터가 열리면 첫 번째 충돌 지점으로 자동 이동합니다.
2
충돌 위치 확인
위쪽 두 패널에서 실제로 충돌한 줄이 앰버(주황)로 강조됩니다. 툴바의 이전 충돌(Previous conflict) / 다음 충돌(Next conflict) 버튼으로 이동하면 세 패널이 함께 스크롤되고, 충돌 N개 남음(N conflicts remaining) 카운터로 진행도를 알 수 있습니다. 모두 해소되면 카운터가 모든 충돌 해소됨(All conflicts resolved) 으로 바뀝니다.
3
한 줄씩 채택
각 충돌 구획에서 내 것 패널 또는 상대 것 패널의 이 쪽 선택(Use this side) 버튼을 누르면 해당 내용이 결과 패널에 반영됩니다. 채택된 쪽은 초록으로 바뀌고 버튼 표기도 선택됨(Selected) 으로 변하며, 양쪽을 모두 켜면 내 것 다음에 상대 것 순서로 합쳐집니다. 결과 패널에서 미해소 구획은 앰버, 해소된 구획은 초록으로 표시됩니다.
4
한쪽으로 일괄 채택 (선택)
패널 헤더의 내것 적용(Apply ours) 또는 상대것 적용(Apply theirs) 버튼을 누르면 파일의 모든 충돌을 한 번에 그 쪽으로 채택합니다.
5
직접 편집 (선택)
결과 패널은 자유롭게 편집할 수 있습니다. 두 변경을 섞거나 새 코드를 쓰고 충돌 마커(
<<<<<<< 등)를 지우면 그 구획은 해소로 판정됩니다.6
저장 & 스테이지
모든 충돌이 사라지면 저장 & 스테이지(Save & stage) 버튼이 활성화됩니다. 누르면 결과가 파일에 기록되고 스테이지되어 해당 파일이 해결 완료로 표시됩니다. 탭이 닫히고 다음 충돌 파일로 자동 이동합니다.
내것 적용으로 일괄 채택하면 파일의 모든 구획이 한 번에 채택되어 결과 패널이 전부 해소(초록) 상태가 되고, 저장 & 스테이지가 활성화됩니다.
파일 삭제 충돌
한쪽에서 파일을 삭제하고 다른 쪽에서 수정한 경우(modify/delete)에는 3분할 에디터 대신 어느 쪽이 삭제했는지 알리는 안내문과 삭제(Delete) / 파일 유지(Keep file) 버튼이 나타나고, 아래에 삭제되지 않고 남은 쪽의 내용이 읽기 전용으로 표시됩니다. 파일을 남길지 지울지 고르면 그 파일의 충돌이 해결됩니다.외부 머지 툴 사용
CodeMirror 기반 인앱 에디터 대신 익숙한 외부 툴로 열 수도 있습니다.1
머지 툴 지정
설정 → ParalleLane → Git의 머지 툴(Merge tool) 드롭다운에서 툴을 선택합니다. 목록은
git mergetool --tool-help가 알려주는 툴(meld, kdiff3, opendiff, vscode 등)로 채워지고, 이 머신에 설치되지 않은 항목은 (not installed)로 표시되며 선택할 수 없습니다. ParalleLane은 git mergetool에 위임하므로 별도 등록이 필요 없습니다.2
외부 툴로 열기
머지 탭 상단 헤더의 렌치 아이콘(외부 머지툴로 열기(Open in external merge tool)) 버튼을 눌러 지정한 툴로 현재 충돌 파일을 엽니다. 툴을 아직 고르지 않았다면 먼저 설정하라는 안내가 뜹니다.
해결 후 계속 또는 중단
진행 중 배너가 있는 경로에서는 모든 충돌 파일을 해결한 뒤 워킹 카피 배너에서 작업을 마무리합니다.계속 / 머지 커밋
남은 충돌이 0이 되면
계속(또는 머지 커밋) 버튼이 활성화됩니다. 누르면 머지는 머지 커밋을 만들고, 체리픽·되돌리기·리베이스는 다음 단계로 진행합니다.중단
중단은 곧바로 실행되지 않고 작업을 중단할까요? 확인 창을 먼저 띄웁니다. 확인하면 작업 전체를 취소하고 이전 상태로 되돌리며, 지금까지 해결한 충돌 내용은 사라집니다.리베이스는 커밋마다 멈출 수 있어, 한 커밋을 해결하고
계속하면 다음 커밋에서 또 충돌이 날 수 있습니다. 이 커밋을 건너뛰려면 배너의 건너뛰기(Skip) 를 사용하세요. 이 버튼은 리베이스 중에만 나타나고, 누르면 이 커밋을 건너뛸까요? 확인 창을 거칩니다.