실무에서 바로 통하는 Git 기초와 효율적인 버전 관리 가이드

6년 차 백엔드 수많은 프로젝트를 거치며 깨달은 점이 있다. 코딩 실력만큼이나 중요한 것이 바로 버전 관리 시스템(VCS)을 다루는 능력이다. 협업 과정에서 발생하는 Merge Conflict를 해결하지 못해 쩔쩔매거나, 실수로 원격 저장소(Remote Repository)의 메인 브랜치를 덮어쓰는 사고는 생각보다 빈번하게 일어난다. 이번에 인프런의 '실무자가 알려주는 Git - 입문편'을 수강하며 주니어 개발자들이 실무에서 반드시 알아야 할 핵심 내용을 정리했다. 이 강의는 단순한 명령어 나열을 넘어 실무 활용도가 높은 워크플로우를 중심으로 구성되어 있어 가성비 강의로 손색이 없다.

Git의 핵심 개념과 Staging Area 이해하기

Git은 파일의 변경 사항을 스냅샷 형태로 저장하여 과거의 특정 시점으로 되돌릴 수 있게 해주는 도구다. 단순히 파일을 복사하는 방식이 아니라, Staging Area라는 중간 단계를 거쳐 커밋(Commit)을 생성하는 구조를 이해하는 것이 입문자 가이드의 첫걸음이다.

많은 입문자가 git add와 git commit의 차이를 혼동한다. 작업 디렉토리에서 수정한 파일 중 커밋에 포함할 파일만 골라내는 과정이 바로 Staging이다. 이를 통해 논리적으로 연관된 변경 사항만 묶어서 하나의 버전으로 만들 수 있다. 개발 생산성을 높이려면 한 커밋에 너무 많은 변경 사항을 담지 않는 것이 중요하다. 코드 리뷰 시 가독성을 높이기 위해서라도 의미 있는 단위로 나누어 커밋하는 습관을 들여야 한다.

실무에서 자주 사용하는 CLI 명령어 8가지

GUI 툴인 소스트리(SourceTree)나 VS Code Git Extension도 훌륭하지만, 결국 복잡한 문제를 해결할 때는 CLI 명령어가 가장 확실하다. 터미널 환경에서 명령어를 직접 입력하며 동작 원리를 익히는 것이 장기적으로 실력 향상에 도움이 된다.

강의 커리큘럼 분석 결과, 실무에서 80% 이상의 비중을 차지하는 명령어는 정해져 있다. 아래는 내가 실무에서 매일 사용하는 기본적인 명령어 흐름이다.

# 저장소 초기화 및 상태 확인
git init
git status

# 변경 사항 스테이징 및 커밋
git add . 
git commit -m "feat: 사용자 로그인 API 구현"

# 원격 저장소 연결 및 푸시
git remote add origin [URL]
git push origin main

브랜치 전략과 협업을 위한 Pull Request(PR) 활용

효과적인 협업을 위해서는 브랜치 전략을 수립하고 Pull Request(PR)를 통한 코드 검토 과정을 거쳐야 한다. Git Flow와 같은 정형화된 모델을 참고하여 팀의 상황에 맞는 규칙을 정하는 것이 협업 툴 활용의 핵심이다.

브랜치는 독립적인 작업 공간을 제공한다. 기능을 개발할 때는 feature 브랜치를 생성하고, 작업이 완료되면 PR을 올려 동료들의 코드 리뷰를 받는다. 이 과정에서 발생할 수 있는 Merge Conflict는 피할 수 없는 숙명과도 같다. 충돌이 발생했을 때 당황하지 않고 해당 파일을 열어 <<<<<<< HEAD와 ======= 사이의 코드를 정리하는 능력이 필요하다. 최근에는 VS Code Git Extension 덕분에 충돌 해결이 훨씬 수월해졌다.

Git Reset, Revert, Stash로 실수 만회하기

개발 중 실수는 언제나 발생하며, Git은 이를 되돌릴 수 있는 강력한 기능을 제공한다. 상황에 따라 Git Reset과 Git Revert를 구분해서 사용하는 것이 실무자의 노하우다.

이미 원격 저장소에 푸시된 커밋을 삭제하고 싶을 때는 git reset보다는 git revert를 권장한다. Reset은 커밋 히스토리 자체를 지워버리기 때문에 협업 시 다른 팀원들의 저장소와 꼬일 위험이 크다. 반면 Revert는 잘못된 내용을 되돌리는 새로운 커밋을 추가하므로 안전하다. 또한, 급하게 브랜치를 전환해야 하는데 현재 작업 중인 내용을 커밋하기 애매할 때는 git stash를 활용해 임시 저장소에 보관해둘 수 있다.

# 작업 내용 임시 저장
git stash

# 다른 브랜치 작업 후 다시 가져오기
git stash pop

# 특정 커밋으로 강제 되돌리기 (주의 필요)
git reset --hard [COMMIT_ID]

성숙한 개발 문화를 위한 커밋 메시지 컨벤션

커밋 메시지는 프로젝트의 이력서와 같아서, 누구나 이해할 수 있는 명확한 규칙에 따라 작성해야 한다. 좋은 커밋 메시지는 코드 리뷰 시간을 단축시키고 향후 유지보수 시 변경 이유를 쉽게 파악하게 해준다.

보통 feat:, fix:, docs: 같은 접두사를 사용하는 Angular 컨벤션을 많이 따른다. 예를 들어 버그를 수정했다면 fix: 로그인 시 간헐적 튕김 현상 수정과 같이 작성한다. 또한 프로젝트 루트에 .gitignore 파일을 설정하여 빌드 결과물이나 환경 설정 파일(env)이 GitHub에 올라가지 않도록 관리하는 것도 잊지 말아야 한다. 때로는 특정 커밋만 골라 적용해야 하는 Cherry-pick이나 히스토리를 깔끔하게 정리하는 Git Rebase 같은 고급 기술이 필요할 때도 있지만, 입문 단계에서는 기본 컨벤션을 지키는 것만으로도 충분하다.

이 강의의 유일한 단점은 CLI 중심이라 터미널에 익숙하지 않은 초보자에게는 초반 진입장벽이 있을 수 있다는 점이다. 하지만 3번 정도 반복해서 명령어를 쳐보면 금방 손에 익는다. 단순히 '코딩'만 하는 사람이 아니라 '협업'할 줄 아는 개발자가 되고 싶다면 이 과정은 필수다.

• Git 입문자를 위한 필수 체크리스트

[ ] .gitignore를 설정하여 불필요한 파일 제외하기

• 팀 내 커밋 메시지 컨벤션 확인 및 준수
• 브랜치 생성 전 항상 git pull로 최신 상태 유지
• PR을 올리기 전 로컬에서 Merge Conflict 여부 확인
• git stash를 활용해 작업 흐름 끊기지 않게 관리

출처

1. 인프런 - 실무자가 알려주는 Git - 입문편