3.10. 자주 묻는 질문 (FAQ)

Git과 GitHub를 Eclipse와 연동하여 사용하는 과정에서 초보자가 자주 궁금해하는 질문과 답변을 모았습니다. 아래 내용을 통해 형상관리에 대한 이해를 높이고, 흔히 겪는 문제를 해결하는 데 도움을 얻으세요.

---

1. Git과 GitHub는 어떻게 다른가요?

• Git: 로컬에서 코드 변경 사항을 추적하고 버전을 관리하는 **분산 버전 관리 시스템(DVCS)**입니다.
• GitHub: Git을 기반으로 한 클라우드 플랫폼으로, 코드 저장소를 원격에서 관리하고 팀 협업 기능(예: Pull Request, Issue Tracking)을 제공합니다.
• 쉽게 말해, Git은 도구이고, GitHub는 Git을 활용하는 서비스입니다.

---

2. Eclipse에서 Git을 사용하는 이유는 무엇인가요?

Eclipse는 개발 중인 프로젝트와 Git을 통합적으로 관리할 수 있는 환경을 제공합니다. 주요 장점은 다음과 같습니다:

• IDE 내부에서 바로 형상관리 작업 수행 가능(커밋, 푸시, 병합 등).
• Git 플러그인(EGit)을 통해 GitHub와의 연동이 간편.
• 브랜치, 커밋 히스토리 등을 Eclipse 인터페이스에서 시각적으로 관리 가능.

---

3. 왜 브랜치를 사용해야 하나요?

브랜치를 사용하면 다음과 같은 이점을 얻을 수 있습니다:

• 독립적인 작업 환경: 팀원들이 서로 간섭 없이 작업할 수 있습니다.
• 기능별 분리: 새로운 기능 개발, 버그 수정 등을 각기 다른 브랜치에서 진행 가능.
• 안전한 코드베이스 유지: main 또는 master 브랜치를 안정적으로 유지하면서 개발이 가능합니다.

---

4. 푸시(Push)와 풀(Pull)의 차이는 무엇인가요?

• Push: 로컬 저장소의 변경 사항을 원격 저장소(GitHub)에 업로드합니다.
• Pull: 원격 저장소의 최신 변경 사항을 로컬 저장소로 가져옵니다.
• 푸시는 내가 작업한 결과를 공유하고, 풀은 팀원들의 작업 결과를 반영하기 위해 사용합니다.

---

5. Eclipse에서 GitHub 연동 중 인증 문제가 발생하면 어떻게 하나요?

인증 오류는 주로 다음 두 가지 이유로 발생합니다:

1. HTTPS 자격 증명 문제: GitHub의 보안 정책에 따라 사용자명과 비밀번호 대신 **토큰(Personal Access Token)**을 사용해야 합니다.
   • 해결 방법: GitHub에서 토큰 생성 후 Eclipse에 설정.
2. SSH 키 문제: SSH 키가 GitHub에 등록되지 않았거나 잘못 설정되었습니다.
   • 해결 방법: SSH 키를 생성하여 GitHub에 등록 후, 연결을 SSH 방식으로 변경.

---

6. 병합(Merge) 중 충돌이 발생하면 어떻게 해결하나요?

병합 충돌은 동일한 파일의 같은 부분이 서로 다르게 수정된 경우 발생합니다. 해결 방법은 다음과 같습니다:

1. 충돌 파일 확인: Eclipse의 Git Staging 뷰에서 충돌 파일을 확인합니다.
2. 수동 수정: 충돌 지점을 직접 수정하여 최종 내용을 결정합니다.
3. 커밋 완료: 수정된 파일을 스테이징하고 병합 커밋을 완료합니다.

---

7. GitHub Actions란 무엇인가요?

GitHub Actions는 GitHub에서 제공하는 자동화 도구입니다. 주요 기능은 다음과 같습니다:

• 코드 푸시 시 자동으로 빌드, 테스트, 배포 실행.
• 워크플로우 파일(.yml)을 작성하여 다양한 작업을 정의.
• Eclipse 프로젝트와 연동해 CI/CD를 구축할 수 있습니다.

---

8. 왜 .gitignore 파일이 필요한가요?

.gitignore 파일은 Git에서 추적하지 않을 파일 또는 디렉토리를 정의합니다. 예를 들어:

• 빌드 파일: *.class, *.exe
• 환경 파일: .env, node_modules/
• IDE 설정 파일: .settings/, .project 이 파일을 설정하면 불필요한 파일이 저장소에 포함되지 않아 프로젝트가 더 깔끔해집니다.

---

9. 초보자가 흔히 실수하는 Git 사용 사례는 무엇인가요?

1. 로컬 저장소와 원격 저장소 간 동기화 부족:
   • 최신 변경 사항을 Pull하지 않고 바로 Push하여 충돌 발생.
2. 브랜치 사용 부족:
   • 모든 작업을 main 브랜치에서 진행하여 코드 안정성이 저하.
3. 불명확한 커밋 메시지:
   • 예: "Changed stuff" 대신 "Fix login validation issue"처럼 명확하게 작성해야 함.
4. .gitignore 설정 누락:
   • 불필요한 파일이 저장소에 포함되어 저장소 크기가 증가하고 혼란 초래.

---

10. GitHub와 Eclipse를 시작하는 데 어려움이 있다면 어떻게 하나요?

• GitHub 공식 문서:
  • GitHub Docs에서 다양한 사용 사례를 참고하세요.
• Eclipse 커뮤니티:
  • Eclipse 포럼이나 Q&A 플랫폼(예: Stack Overflow)에서 문제 해결 팁을 찾으세요.
• Git 학습 자료:
  • Pro Git 책을 통해 Git의 원리를 깊이 이해하세요.

---

마무리

Git과 GitHub는 소프트웨어 개발에서 필수적인 도구이며, Eclipse와 통합하면 생산성을 극대화할 수 있습니다. 이 FAQ를 참고하여 흔히 발생하는 문제를 해결하고, 협업 환경에서 자신감을 가지고 작업하세요. 지속적인 연습과 학습으로 전문가 수준의 형상관리 역량을 갖출 수 있습니다.