Git 오류를 만났을 때 처음부터 강제 푸시나 기록 초기화를 시도하면 팀원의 변경 사항까지 영향을 줄 수 있습니다. 먼저 현재 브랜치와 변경 파일을 확인하고, 로컬 문제인지 원격 저장소와의 차이인지 구분하세요.
1. 상태를 먼저 읽기
git status는 수정된 파일, 스테이징된 파일, 충돌 상태를 보여 줍니다. 명령 결과를 읽지 않은 채 복구 명령을 복사해 실행하지 마세요. Git 공식 문서에서 각 상태의 의미를 확인할 수 있습니다.
2. 변경을 버리기 전에 저장 범위 정하기
내가 수정한 파일인지, 팀원의 변경인지, 이미 커밋된 내용인지부터 확인합니다. git restore는 지정한 파일을 복원할 수 있지만 작업 내용을 잃을 수도 있으므로 적용 대상을 정확히 봐야 합니다. 공식 restore 문서의 작업 트리와 스테이징 영역 설명을 읽고 사용하세요.
3. 병합 충돌은 두 변경을 비교하기
충돌 표시가 있는 파일을 열어 각 변경의 의도를 확인하고 필요한 내용을 합쳐야 합니다. 한쪽을 무조건 선택하면 정상 기능을 지울 수 있습니다. 수정 후 테스트하고 해결한 파일만 스테이징하세요. GitHub의 충돌 해결 안내는 명령줄에서 파일을 확인하는 순서를 설명합니다.
4. 이미 공유한 이력은 조심하기
커밋 메시지를 바꾸거나 과거 커밋을 수정하면 커밋 ID가 달라집니다. 공유 브랜치에서 강제 푸시가 필요한 작업은 협업자와 먼저 조율하세요. GitHub 공식 안내도 공유 이력 수정의 영향을 설명합니다.
포트폴리오에 남길 기록
오류 메시지, 원인, 확인한 명령, 해결 후 테스트 결과를 짧게 적으세요. 명령어 암기보다 협업 과정에서 어떤 판단을 했는지가 드러납니다. 기초 학습 순서는 Git 강의 선택 기준에서 확인하세요.