FastAPI 프로젝트에서 사용한 Git 명령어 정리

💡 FastAPI 프로젝트에서 사용한 Git 명령어 정리

OpenAI API 연동과 MySQL 데이터베이스 전환 작업을 하면서 Git을 이용해 브랜치를 관리하고, 변경사항을 안전하게 커밋하고, 원격 저장소와 동기화하는 과정을 학습했습니다.

다음은 그 과정에서 사용한 핵심 Git 명령어들과 그 활용법입니다.

1️⃣ Git 저장소 Clone

git clone https://github.com/사용자명/fastapi.git
cd fastapi

2️⃣ 브랜치 확인

• 현재 브랜치 확인: git branch
• 원격 브랜치 확인: git branch -a, git branch -r

3️⃣ 브랜치 생성 및 전환

git checkout -b OpenAI origin/OpenAI

origin/OpenAI는 원격 서버에 있는 브랜치이며, OpenAI라는 로컬 브랜치로 생성합니다.

4️⃣ 현재 상태 확인

git status

5️⃣ 변경사항 저장

스테이지에 추가

git add main.py openai_utils.py routers/poem.py

커밋 메시지와 함께 저장

git commit -m "Add OpenAI 감상문 생성 기능"

6️⃣ 원격 저장소로 Push

git push origin OpenAI

7️⃣ 브랜치 병합

git checkout main
git merge OpenAI

8️⃣ 로컬 변경사항 임시 저장 (선택)

git stash
git checkout 브랜치명
git stash pop

9️⃣ 디렉토리 삭제 후 다시 Clone

rm -rf fastapi
git clone https://github.com/사용자명/fastapi.git
cd fastapi
git checkout OpenAI

---

✍️ 마무리하며

Git은 단순한 백업 도구를 넘어서 프로젝트를 체계적으로 관리하고 협업을 가능하게 합니다.

오늘처럼 브랜치를 나누고, 필요한 기능을 독립적으로 개발하며, 최종적으로 병합하는 방식은 현업에서도 널리 쓰이는 개발 전략입니다.

 

앞으로도 기능 추가 시마다 브랜치를 따로 생성하여 관리하고, 변경 내역을 명확히 기록하는 습관을 가지면 안정적인 개발에 큰 도움이 됩니다.

---

이 글은 FastAPI + MySQL + OpenAI 프로젝트 실습을 기반으로 작성한 Git 학습 정리입니다.