Git, 이제는 두렵지 않아요: 완벽주의자를 위한 단계별 커밋 가이드

oversleep·2025년 2월 12일

git

목록 보기
1/11
post-thumbnail

Git 작업 흐름 이해하기: 차근차근 배우는 커밋 과정

들어가며

Git을 처음 사용하거나, 알음알음 사용하다 보면 매번 명령어를 입력할 때마다 긴장되곤 합니다.
이 글에서는 실제 작업 사례를 통해 Git의 기본적인 작업 흐름을 자세히 알아보겠습니다.

기본 작업 흐름

1. 새로운 브랜치 생성

작업 시작 전, 새로운 브랜치를 생성합니다.
브랜치 이름은 작업 내용을 잘 나타내도록 짓는 것이 좋습니다.

# 새 브랜치 생성 및 이동
git checkout -b feat/feature-name

2. 파일 변경사항 스테이징

변경된 파일들을 커밋하기 위해 스테이징 영역에 추가합니다.

# 특정 파일들 스테이징
git add package.json package-lock.json src/components/FeatureComponent.tsx

# 변경된 파일 확인
git status

3. 커밋하기

스테이징된 변경사항을 커밋합니다. 커밋 메시지는 두 가지 방식으로 작성할 수 있습니다.

방법 1: 인라인 커밋 메시지

git commit -m "feat: 새로운 기능 구현" -m "- 주요 기능 1 추가
- 관련 컴포넌트 구현
- API 연동"

방법 2: 에디터로 커밋 메시지 작성

git commit

VSCode나 설정된 에디터가 열리면 다음과 같은 형식으로 작성:

feat: 새로운 기능 구현

- 주요 기능 1 추가
- 관련 컴포넌트 구현
- API 연동

4. 원격 저장소에 푸시

작업한 내용을 원격 저장소에 업로드합니다.

git push origin feat/feature-name

5. Pull Request 생성

  1. GitHub에서 "Compare & pull request" 버튼 클릭

  2. PR 제목과 설명 작성

    ## 구현 내용
    1. 주요 기능 1
       - 세부 구현 사항
       - 변경 사항 설명
    
    2. 주요 기능 2
       - 세부 구현 사항
       - 변경 사항 설명
  3. "Create pull request" 클릭

6. 작업 마무리

PR이 승인되고 머지된 후:

# main 브랜치로 이동
git checkout main

# 최신 변경사항 가져오기
git pull origin main

# 작업 완료된 로컬 브랜치 삭제
git branch -d feat/feature-name

주의사항

  1. 브랜치 이름은 작업 내용을 명확히 표현하도록 작성
  2. 커밋 메시지는 변경사항을 이해하기 쉽게 작성
  3. 하나의 커밋은 하나의 논리적 변경사항만 포함
  4. 사용했던 브랜치 이름은 재사용하지 않기

마치며

Git이 처음에는 어려울 수 있지만, 이러한 기본적인 흐름을 이해하고 나면 훨씬 자신감 있게 사용할 수 있습니다.
중요한 것은 각 단계가 어떤 의미를 가지는지 이해하는 것입니다.

이 글이 Git을 처음 접하는 분들께 도움이 되었기를 바랍니다. 더 나은 개발 문화를 위해 우리 모두 체계적인 Git 사용을 실천해보아요!

profile
궁금한 것, 했던 것, 시행착오 그리고 기억하고 싶은 것들을 기록합니다.

0개의 댓글