1. 개요
현대 소프트웨어 개발 환경에서 Git은 협업 및 코드 버전 관리를 위한 필수 도구입니다. 본 내용은 Git의 다양한 기능—.gitignore, Merge, Branch, Git Flow, 충돌 해결—에 대해 실무적인 관점에서 정리한 자료입니다. 각 항목별로 기본 개념, 사용법 및 주의사항을 명확하게 구분하여 설명하며, 단락 전환 시 "..." 기호를 사용해 명확한 구분을 두었습니다. 추가적으로 알아두면 좋은 팁도 포함하였습니다.
2. .gitignore – Git에 포함되지 않을 파일 지정하기
2-1 .gitignore란?
Git에서 특정 파일이나 폴더를 버전 관리 대상으로부터 제외하도록 설정하는 파일입니다. 주로 빌드 파일, 환경 설정 파일, 캐시 파일 등 민감하거나 관리 불필요한 파일을 제외할 때 사용됩니다.
2-2 .gitignore 기본 사용법
- 프로젝트 루트 디렉토리에 .gitignore 파일 생성
- 제외할 파일 또는 폴더 추가
# 특정 파일 제외
.env
config.php
# 특정 폴더 제외
node_modules/
vendor/
# 특정 확장자 제외
*.log
*.tmp
# 특정 패턴 제외
debug_*
2-3 이미 Git에 올라간 파일을 .gitignore에 추가하는 방법
기존 파일은 자동으로 제외되지 않으므로, 아래 명령어를 사용해 캐시를 초기화 후 재커밋합니다.
git rm -r --cached .
git add .
git commit -m "Update .gitignore"
3. Git Merge – 브랜치 병합 방법
3-1 Merge란?
Git에서 두 개 이상의 브랜치를 하나로 합치는 작업을 의미하며, 신규 기능 개발 후 메인 브랜치에 통합하는 과정 등에서 사용합니다.
3-2 Merge 방식 비교
| 방식 | 설명 | 장점 | 단점 |
| Fast-forward | 브랜치가 변경 사항 없이 직선으로 이어질 때 사용 | 커밋 히스토리가 깔끔 | 브랜치 구분이 모호해질 수 있음 |
| Recursive Merge | 서로 다른 변경 사항이 있는 브랜치를 병합 (기본 Merge 방식) | 일반적인 Merge 방식 | 충돌 발생 가능 |
| Squash Merge | 여러 커밋을 하나로 합쳐 병합 | 커밋 히스토리 정리 | 세부 변경 내역이 축소됨 |
| Rebase | 브랜치의 베이스를 변경하여 커밋 히스토리를 정리 | 깔끔한 히스토리 유지 | 충돌 발생 시 해결이 복잡할 수 있음 |
3-3 Merge 기본 사용법
- 기본 Merge (Fast-forward 또는 Recursive Merge)
- git checkout main git merge feature-branch
- Squash Merge (커밋 정리 후 병합)
- git checkout main git merge --squash feature-branch git commit -m "Squash merge: feature-branch"
- Rebase (커밋 히스토리 정리)
- git checkout feature-branch git rebase main git checkout main git merge feature-branch
3-4 추가 팁
Merge 과정에서는 반드시 병합 전 최신 상태의 브랜치를 기반으로 작업하며, 가능하면 로컬에서 충분한 테스트 후 Merge를 진행하는 것이 좋습니다.
4. Git Branch – 브랜치 전략과 사용법
4-1 Branch란?
Git에서 각 개발 작업을 독립적으로 진행할 수 있는 분리된 작업 공간입니다. 메인 브랜치(main, master)에 영향을 주지 않고 기능 개발, 버그 수정 등을 진행할 수 있습니다.
4-2 기본 브랜치 종류
- main (master): 안정적인 배포 가능한 코드가 위치하는 기본 브랜치
- develop: 개발 진행 및 테스트를 위한 브랜치
- feature/: 새로운 기능 개발을 위한 개별 브랜치
- bugfix/: 버그 수정 브랜치
- hotfix/: 긴급 수정이 필요할 때 사용하는 브랜치
4-3 브랜치 생성 및 관리 명령어
- 새로운 브랜치 생성 및 이동
- git checkout -b feature-branch
- 브랜치 목록 확인
- git branch
- 다른 브랜치로 이동
- git checkout develop
- 브랜치 삭제
- git branch -d feature-branch
- 원격 브랜치 삭제
- git push origin --delete feature-branch
5. Git 협업을 위한 브랜치 전략
5.1 Git Flow 전략
대규모 프로젝트에서 흔히 사용되는 협업 모델로, 각 브랜치를 역할에 따라 구분하여 개발 및 배포 프로세스를 체계적으로 관리할 수 있습니다.
- main: 실제 서비스에 배포되는 안정적인 브랜치
- develop: 개발 진행 및 통합 테스트용 브랜치
- feature/*: 개별 기능 개발 브랜치
- release/*: 배포 전 테스트 및 최종 검증 브랜치
- hotfix/*: 긴급 수정용 브랜치
5-2 Git Flow 기본 명령어 예시
# feature 브랜치 생성
git checkout -b feature/new-function develop
# 개발 완료 후 develop 브랜치에 병합
git checkout develop
git merge feature/new-function
git branch -d feature/new-function
5-3 추가 고려 사항
각 브랜치의 역할을 명확하게 정의하고, 정기적인 코드 리뷰와 통합 테스트를 통해 충돌 및 버그를 미연에 방지하는 전략이 필요합니다.
6. Git 충돌 해결 방법
6-1 충돌 발생 원인
Merge 또는 Rebase 과정 중 여러 개발자가 동일 파일의 동일 부분을 수정할 때 충돌이 발생합니다.
6-2 충돌 해결 절차
- Merge 도중 충돌 발생 시
Git이 자동 알림을 통해 문제 파일을 표시합니다. - Auto-merging file.txt CONFLICT (content): Merge conflict in file.txt
- 문제 파일 수정 후 Staging 영역에 추가
- git add file.txt git commit -m "Merge conflict resolved"
- Merge 과정 재개
- git merge --continue
6-3 추가 팁
충돌 예방을 위해 작은 단위로 커밋하고, 정기적으로 Pull하여 최신 상태를 유지하는 것이 중요합니다. 또한, 충돌이 빈번한 파일에 대해서는 사전에 작업 조율 및 커뮤니케이션을 통해 문제를 예방하는 것이 좋습니다.
7. 결론 – Git을 효율적으로 사용하려면?
- .gitignore 활용: 불필요한 파일 및 민감한 정보를 관리 대상에서 제외하여 버전 관리의 효율성을 극대화
- Merge 방식 선택: 상황에 맞게 Fast-forward, Squash, Rebase 등 다양한 병합 방식을 적절히 활용
- 브랜치 전략 적용: Git Flow 등 체계적인 브랜치 전략을 통해 팀 협업 및 코드 통합의 효율성을 확보
- 충돌 예방 및 해결: 작고 잦은 커밋, 자주 Pull하는 습관 및 명확한 커뮤니케이션을 통해 Merge 충돌을 최소화
8. 참고 자료
추가로, Git 사용 시 git status, git log 등의 명령어를 활용해 현재 작업 상태를 항상 확인하고, 변경 사항 추적에 주의를 기울이는 것도 좋은 실무 팁입니다.
이와 같이 정리된 내용을 통해 Git의 주요 기능들을 체계적으로 이해하고, 현업에서 효율적인 버전 관리 및 협업을 구현할 수 있을 것입니다.