DaleSchool

파일과 커밋

입문15분

학습 목표

  • GitHub 웹에서 새 파일을 만들고 수정할 수 있다
  • 커밋 메시지를 의미 있게 작성할 수 있다
  • 커밋 이력(History)에서 변경 사항을 확인할 수 있다

새 파일 만들기

저장소에서 직접 파일을 만들어봅니다.

  1. 저장소 페이지에서 Add fileCreate new file 클릭
  2. 파일 이름 입력: notes.md
  3. 내용 작성:
# 공부 노트

## 오늘 배운 것

- GitHub 저장소 만들기
- README 작성하기
- 파일 커밋하기

## 다음에 배울 것

- 브랜치
- Pull Request
  1. 아래 Commit changes 섹션에서:
    • 커밋 메시지: docs: 공부 노트 파일 추가
    • Commit directly to the main branch 선택
  2. Commit new file 클릭

파일 수정하기

이미 있는 파일을 수정할 수도 있습니다.

  1. notes.md 파일 클릭
  2. 연필 아이콘(✏️) 클릭
  3. 내용 수정
  4. Commit changes로 저장

커밋 이력 보기

모든 변경 사항이 기록됩니다. 확인해봅니다.

  1. 저장소 메인 페이지에서 N commits 링크 클릭 (파일 목록 위)
  2. 각 커밋을 클릭하면 무엇이 바뀌었는지 볼 수 있습니다
초록색 줄 (+): 추가된 내용
빨간색 줄 (-): 삭제된 내용

이것을 **diff(차이)**라고 합니다.

"왜?" — 커밋 메시지를 잘 써야 하는 이유

커밋 메시지는 미래의 나와 팀원에게 보내는 편지입니다. 6개월 후에 "이 파일을 왜 바꿨더라?"라고 검색할 때 커밋 메시지가 답을 줍니다.

나쁜 커밋 메시지:

수정
asdf
업데이트

좋은 커밋 메시지:

docs: README에 설치 방법 추가
fix: 로그인 버튼 클릭 시 오류 수정
feat: 다크 모드 기능 추가

커밋 메시지 작성 팁:

  • 무엇을 했는지 명확하게 (왜는 필요하면 본문에)
  • 현재형 동사로 시작: "추가", "수정", "삭제"
  • 너무 짧지도, 길지도 않게 (50자 이내 권장)

많은 팀이 feat:, fix:, docs: 같은 타입 접두사를 붙입니다 (Conventional Commits). 일관성을 유지하면 이력을 읽기 쉬워집니다.

심화 학습

파일 삭제하기

GitHub 웹에서 파일을 삭제할 수 있습니다:

  1. 삭제할 파일 열기
  2. 오른쪽 상단 ··· (More options) 또는 쓰레기통 아이콘 클릭
  3. Delete file 선택
  4. 커밋 메시지 입력 후 커밋

삭제도 커밋으로 기록됩니다. History에서 이전 상태를 언제든 복원할 수 있습니다.

파일 업로드하기

터미널 없이 로컬 파일을 GitHub에 올릴 수 있습니다:

  1. Add fileUpload files 클릭
  2. 파일을 드래그 앤 드롭하거나 choose your files 클릭
  3. 커밋 메시지 작성
  4. Commit changes 클릭

한 번에 여러 파일을 올릴 수 있습니다. 단, 폴더 구조는 직접 설정해야 합니다.

  1. 저장소에 notes.md 파일을 새로 만들고, 오늘 배운 내용을 작성하세요.
  2. notes.md를 수정해서 두 번째 커밋을 만드세요.
  3. 커밋 이력(History)에서 변경 사항(diff)을 확인하세요.

Q1. 커밋(Commit)이란 무엇인가요?

  • A) 저장소를 삭제하는 행위
  • B) 파일의 변경 사항을 저장하고 메시지를 남기는 행위
  • C) 다른 저장소의 코드를 복사하는 행위
  • D) 팀원에게 알림을 보내는 행위

참고 자료