Git과 GitHub 초보 가이드 – 코드 관리의 첫걸음 (실습 포함)

by

개발자 채용 공고에서 “Git 사용 경험” 또는 “GitHub 포트폴리오”를 요구하지 않는 곳은 거의 없습니다. Git은 코드의 변경 이력을 관리하는 도구이고, GitHub는 그 코드를 온라인에 저장하고 공유하는 플랫폼입니다. 이 글에서 Git의 개념부터 실제 커밋, GitHub 업로드까지 한 번에 실습합니다.

Git이 필요한 이유

Git 없이 코드를 관리하면 이렇게 됩니다:

프로젝트_최종.zip
프로젝트_최종_수정.zip
프로젝트_진짜최종.zip
프로젝트_진짜최종_v2.zip
프로젝트_이게진짜최종_12월3일.zip

Git을 사용하면 하나의 폴더에서 모든 변경 이력을 관리할 수 있고, 언제든 과거 버전으로 돌아갈 수 있습니다.

핵심 개념 3가지

개념설명비유
Repository (저장소)Git이 관리하는 프로젝트 폴더프로젝트 방
Commit (커밋)특정 시점의 코드 스냅샷 저장게임 세이브 포인트
Branch (브랜치)독립적인 작업 공간평행 세계 (원본에 영향 없이 실험)

Git 설치

OS방법
Windowsgit-scm.com에서 다운로드 설치
Mac터미널에서 xcode-select --install 또는 brew install git
Linuxsudo apt install git (Ubuntu/Debian)
# 설치 확인
git --version
# git version 2.43.0

# 최초 설정 (한 번만)
git config --global user.name "홍길동"
git config --global user.email "hong@example.com"

실습: 첫 번째 커밋 만들기

# 1. 프로젝트 폴더 생성
mkdir my-project
cd my-project

# 2. Git 초기화 (이 폴더를 Git이 관리하기 시작)
git init
# → Initialized empty Git repository

# 3. 파일 생성
echo "# 나의 첫 프로젝트" > README.md
echo "console.log('Hello World');" > app.js

# 4. 상태 확인 (빨간색 = 아직 추적 안 되는 파일)
git status

# 5. 스테이징 (커밋할 파일 선택)
git add README.md app.js
# 또는 전부: git add .

# 6. 커밋 (스냅샷 저장)
git commit -m "첫 번째 커밋: README와 app.js 추가"

# 7. 커밋 이력 확인
git log --oneline
# a1b2c3d 첫 번째 커밋: README와 app.js 추가

핵심 명령어 정리

명령어설명사용 빈도
git init새 저장소 생성프로젝트당 1회
git add .모든 변경 파일 스테이징★★★★★
git commit -m "메시지"스냅샷 저장★★★★★
git status현재 상태 확인★★★★★
git log커밋 이력 보기★★★★☆
git diff변경 내용 확인★★★★☆
git branch브랜치 목록/생성★★★☆☆
git checkout -b 이름새 브랜치 생성 + 이동★★★☆☆
git merge브랜치 합치기★★★☆☆
git push원격 저장소에 업로드★★★★★
git pull원격 저장소에서 다운로드★★★★★
git clone URL원격 저장소 복제★★★★☆

GitHub에 올리기

  1. github.com에서 회원가입 (무료)
  2. 우측 상단 “+” → “New repository” 클릭
  3. 저장소 이름 입력 (예: my-project) → “Create repository”
  4. 터미널에서 다음 명령어 실행:
# GitHub와 연결
git remote add origin https://github.com/유저명/my-project.git

# main 브랜치로 설정
git branch -M main

# GitHub에 업로드
git push -u origin main

# 이후에는 간단하게:
git push

이제 github.com/유저명/my-project에서 내 코드를 확인할 수 있습니다!

일상적인 Git 워크플로우

# 1. 코드 수정
# (에디터에서 파일 수정)

# 2. 변경 내용 확인
git status
git diff

# 3. 스테이징 + 커밋
git add .
git commit -m "로그인 기능 추가"

# 4. GitHub에 업로드
git push

# 이것을 매일 반복!

좋은 커밋 메시지 작성법

나쁜 예좋은 예
“수정”“로그인 페이지 비밀번호 유효성 검사 추가”
“업데이트”“헤더 네비게이션 반응형 레이아웃 적용”
“asdf”“사용자 프로필 이미지 업로드 버그 수정”

규칙: “무엇을 왜 변경했는지”가 커밋 메시지만 봐도 이해되어야 합니다.

마무리

Git의 핵심은 add → commit → push 세 단계입니다. 이것만 알아도 개인 프로젝트 관리와 GitHub 포트폴리오 구축이 가능합니다. 오늘 할 일: ① Git 설치 ② GitHub 가입 ③ 위 실습을 따라하며 첫 커밋 만들기. 30분이면 됩니다. 이것이 개발자 커리어의 첫걸음입니다.

Leave a Comment