Git 기초 및 프로젝트 협업 설정 가이드

프로젝트 문서화(README), Git 핵심 영역과 기본 명령어, 그리고 커밋 컨벤션 정리입니다.

---

1. README 작성

프로젝트 루트 경로에 README.md 파일을 생성하여 프로젝트의 목적과 기본 설명을 기록합니다.

• 생성 위치: 프로젝트 루트 디렉토리
• 파일명: README.md

# Student Console

학생의 이름과 점수를 입력받아 등급과 평균을 출력하는 Java 콘솔 프로그램입니다.

---

2. Git의 3가지 핵심 영역

Git은 파일을 관리할 때 크게 세 가지 공간으로 나누어 작동합니다.

• Working Directory
  • 실제로 파일을 생성하고 코드를 수정하는 로컬 작업 폴더 공간입니다.
• Staging Area
  • git add 명령어로 변경사항을 임시 보관하는 공간입니다. 커밋 전 반영할 파일을 선별합니다.
• Repository (Commit)
  • git commit 명령어로 변경 내역이 영구 기록되는 최종 저장 공간입니다.

---

3. Git 핵심 명령어

📌 주요 명령어 정리

명령어	설명
git init	현재 폴더를 Git 로컬 저장소로 초기화
git status	현재 작업 디렉토리 및 스테이징 상태 확인
git add .	작업 디렉토리의 모든 변경사항(신규/수정/삭제)을 스테이징 영역에 추가
git commit -m "메시지"	스테이징된 변경사항을 커밋 메시지와 함께 최종 저장
git commit -am "메시지"	추적 중인 파일의 수정사항 추가(add)와 커밋을 동시에 수행
git branch	전체 브랜치 목록 확인 및 현재 작업 중인 브랜치 확인
git diff	이전 커밋이나 스테이징 영역 대비 변경된 코드 내용 확인
git clone {URL}	원격 저장소를 로컬 컴퓨터로 복제
git pull	원격 저장소의 최신 변경사항을 가져와 현재 브랜치에 병합

📌 브랜치 push 및 pull

• main 브랜치가 아닐 경우 브랜치명을 직접 명시하여 push 및 pull을 진행합니다.
  • git push origin {브랜치명}
  • git pull origin {브랜치명}

---

4. 원격 저장소 연결 및 Push

GitHub에서 새 레포지토리를 생성한 후, 안내되는 기본 연결 명령어를 복사하여 터미널에서 실행하면 원격 저장소 푸시가 완료됩니다.

---

5. 주의할 점 (.idea 폴더 관리)

.idea 폴더는 JetBrains IDE가 프로젝트마다 생성하는 로컬 설정 폴더입니다.

• 원격 저장소 제외 필요성: 개발자 환경마다 설정이 다를 수 있으므로 Git 원격 레포지토리에 커밋되지 않도록 .gitignore에 등록하거나 관리에서 제외해야 합니다.

좌측 프로젝트 탐색기에서 .idea 폴더 삭제 및 제외 처리:

---

6. Conventional Commit (커밋 컨벤션)

코드 변경 기록을 남길 때 협업자와 도구가 쉽게 이해할 수 있도록 규격화한 일관된 커밋 메시지 표준 규칙입니다.

Type	설명
feat	새로운 기능 추가
fix	버그 수정
docs	문서 변경 (README, 마크다운 문서 등)
style	코드 동작에 영향 없는 포맷팅, 세미콜론 수정 등
refactor	버그 수정이나 기능 추가 없는 코드 구조 개선
perf	성능 개선을 위한 코드 변경
test	테스트 코드 추가 또는 기존 테스트 수정
chore	빌드 작업, 패키지 설정, 기타 보조 도구 변경
ci	CI/CD 설정 파일 및 스크립트 수정 (GitHub Actions 등)