깃(Git)을 사용하다 보면 충돌이나 커밋 누락 같은 예상치 못한 상황을 자주 마주하게 됩니다. 버전 관리 시스템의 핵심 명령어 구조와 실무에서 빈번하게 발생하는 오류 유형별 해결 방법을 정확히 파악해 두면 개발 작업을 훨씬 안전하고 효율적으로 진행할 수 있습니다.
버전 관리를 시작하는 기본 작업 흐름과 명령어
깃은 작업 공간인 워킹 디렉터리, 준비 영역인 스테이징 에어리어, 그리고 히스토리가 기록되는 로컬 저장소의 단계를 거쳐 소스 코드를 관리합니다. 새로운 프로젝트를 시작할 때는 터미널에 git init을 입력해 저장소를 생성하고, 기존 원격 저장소를 가져올 때는 git clone을 활용합니다.
일상적인 코딩 작업에서는 변경된 상태를 파악하는 git status와 수정한 파일을 올리는 git add, 그리고 변경 기록을 남기는 git commit 명령어가 기본적으로 사용됩니다. 커밋 메시지는 무엇을 수정했는지 명확히 알 수 있도록 간결하고 구체적으로 작성하는 것이 실무 표준입니다.
실무에서 가장 자주 마주하는 Git 오류와 해결 대책
협업 과정이나 개인 작업 중 발생할 수 있는 대표적인 에러 상황과 그에 맞는 올바른 대처 방식을 비교하여 정리했습니다. 상황에 맞지 않는 명령어를 쓰면 데이터가 유실될 수 있으므로 주의해야 합니다.
| 오류 및 문제 상황 | 발생 원인 | 권장 해결 명령어 및 방법 |
|---|---|---|
| 원격 저장소 충돌 (Merge Conflict) | 동일한 파일의 같은 줄을 다른 사람이 먼저 수정 후 푸시함 | 충돌 기호 수정 후 git add 및 git commit 재진행 |
| 커밋 파일 누락 및 오타 수정 | 최신 커밋 직후 빠진 파일이나 메시지 수정 필요 | git add 후 git commit --amend 실행 |
| 급하게 브랜치를 바꿔야 할 때 | 미완성 작업이 있어 브랜치 전환 시 에러 발생 | git stash로 임시 저장 후 복귀 시 git stash pop |
과거의 특정 시점으로 되돌리는 Reset과 Revert의 차이점
잘못 작성된 코드를 과거로 돌려야 할 때 깃은 reset과 revert라는 두 가지 서로 다른 방식을 제공합니다. git reset --soft HEAD~1은 최근 커밋을 취소하더라도 내가 수정했던 코드 흔적을 스테이징 상태로 남겨두어 재조정이 편리합니다. 반면 --hard 옵션을 붙이면 작성 중이던 코드까지 모두 지워지므로 각별한 주의가 필요합니다.
이미 원격 저장소에 코드가 공유된 협업 환경이라면 역사를 지우는 방식보다, 문제가 된 변경 사항을 정반대로 상쇄하는 새로운 커밋을 만들어주는 git revert <커밋ID> 명령어를 사용하는 것이 이력 보존 측면에서 훨씬 안전합니다.
불필요한 파일을 추적에서 제외하는.gitignore 활용법
프로젝트 폴더 안에는 컴파일 과정에서 생성되는 빌드 결과물, 운영 체제 임시 파일, 그리고 API 키나 데이터베이스 비밀번호가 담긴 환경변수 파일(.env)처럼 외부에 노출되거나 굳이 버전 관리할 필요가 없는 파일들이 존재합니다.
프로젝트 최상단에 .gitignore 파일을 생성하고 제외할 파일이나 폴더명을 명시해 두면, 실수로 민감한 정보나 불필요한 캐시 파일이 깃허브 같은 원격 저장소에 업로드되는 보안 사고를 사전에 완벽하게 방지할 수 있습니다.
깃과 깃허브는 완전히 같은 프로그램인가요?
깃은 버전 관리 도구이고 깃허브는 원격 호스팅 웹 서비스입니다.
작업 중인 코드를 지우지 않고 잠시 숨기고 싶어요
git stash 명령어로 임시 보관했다가 나중에 꺼내 쓰세요.
커밋 메시지를 잘못 적었는데 수정할 수 있나요?
푸시 전이라면 git commit –amend로 덮어쓸 수 있습니다.