깃허브(GitHub) 입문 — Git 설치부터 커밋·푸시까지 비전공자도 따라 하는 방법

한 줄 요약: Git은 내 컴퓨터에서 코드의 변경 이력을 기록하는 도구이고, GitHub는 그 기록을 인터넷에 안전하게 보관하는 저장소입니다. add → commit → push 세 단계만 익히면 입문은 끝입니다.

Git과 GitHub, 뭐가 다른가요?

이름이 비슷해 헷갈리지만 역할이 다릅니다.

구분	Git	GitHub
정체	버전 관리 프로그램	Git 저장소를 올려두는 웹 서비스
위치	내 컴퓨터	인터넷(클라우드)
하는 일	변경 이력 기록, 이전 상태로 되돌리기	백업, 공유, 협업, 자동 배포 연동
비유	게임의 저장 기능	저장 파일을 올려두는 클라우드

"작업하다가 망가졌을 때 어제 상태로 돌아갈 수 있다"는 것이 가장 큰 장점입니다. 또한 Vercel, Cloudflare 같은 배포 서비스는 GitHub에 푸시하면 자동으로 사이트를 업데이트해 줍니다. 배포 방법은 Vercel로 블로그 배포하기에서 이어서 확인하세요.

1단계. Git 설치하기

1. git-scm.com에서 내 운영체제에 맞는 설치 파일을 받습니다.
2. Windows는 설치 중 나오는 옵션을 모두 기본값으로 두고 Next를 눌러 진행해도 됩니다.
3. 설치가 끝나면 터미널(또는 VS Code의 터미널)에서 아래 명령으로 확인합니다.

git --version

버전 번호가 출력되면 설치 성공입니다. VS Code 사용이 처음이라면 VS Code 설치와 첫 코드 작성을 먼저 보고 오시면 편합니다.

2단계. 내 정보 등록하기 (처음 한 번만)

커밋 기록에 "누가 수정했는지"가 남도록 이름과 이메일을 등록합니다.

git config --global user.name "내이름"
git config --global user.email "내이메일@example.com"

이메일은 GitHub 계정에 등록한 주소와 같게 하는 것이 좋습니다. 같아야 내 활동 기록(잔디)에 정상 반영됩니다.

3단계. GitHub 가입하고 저장소 만들기

1. github.com에서 무료 계정을 만듭니다.
2. 오른쪽 위 + 버튼에서 New repository를 선택합니다.
3. 저장소 이름(예: my-blog)을 입력합니다.
4. 공개 범위를 선택합니다. 연습용이나 개인 자료는 Private을 권장합니다.
5. Create repository를 누르면 저장소 주소(https://github.com/내아이디/my-blog.git)가 나옵니다.

4단계. 내 프로젝트를 GitHub에 올리기

프로젝트 폴더에서 터미널을 열고 아래 명령을 순서대로 실행합니다.

# 1. 이 폴더를 Git이 관리하도록 시작
git init

# 2. 모든 변경 파일을 "올릴 후보"로 담기
git add .

# 3. 변경 내용을 기록으로 남기기 (메시지는 자유롭게)
git commit -m "첫 번째 커밋"

# 4. 기본 브랜치 이름을 main으로 설정
git branch -M main

# 5. GitHub 저장소 주소 연결
git remote add origin https://github.com/내아이디/my-blog.git

# 6. GitHub로 올리기
git push -u origin main

처음 push할 때 로그인 창이 뜨면 GitHub 계정으로 로그인하세요. 성공하면 GitHub 저장소 페이지를 새로고침했을 때 내 파일들이 보입니다.

add, commit, push 한 번에 이해하기

명령	하는 일	비유
git add	저장할 파일을 선택해서 담기	택배 상자에 물건 담기
git commit	담은 내용을 하나의 기록으로 확정	상자 포장하고 송장 쓰기
git push	기록을 GitHub로 전송	택배 발송

이후 코드를 수정할 때마다 git add . → git commit -m "수정 내용" → git push 세 줄만 반복하면 됩니다.

자주 쓰는 Git 명령어 모음

명령	설명
git status	지금 어떤 파일이 바뀌었는지 확인
git log --oneline	커밋 기록을 한 줄씩 보기
git diff	무엇이 어떻게 바뀌었는지 상세 비교
git pull	GitHub의 최신 내용을 내 컴퓨터로 가져오기
git clone 주소	GitHub 저장소를 내 컴퓨터에 통째로 복사

꼭 지켜야 할 보안 습관: .gitignore

비밀번호, API 키, 환경 변수 파일(.env.local 등)은 절대 GitHub에 올리면 안 됩니다. 특히 공개 저장소에 올라간 키는 순식간에 악용될 수 있습니다. 프로젝트 최상위에 .gitignore 파일을 만들고 아래처럼 올리지 않을 파일을 적어 두세요.

node_modules/
.env
.env.local
.next/

이미 실수로 올렸다면 해당 키를 즉시 폐기하고 새로 발급받으세요. 파일만 삭제해도 과거 커밋 기록에 남아 있기 때문입니다.

자주 만나는 오류와 해결법

오류 메시지	원인	해결
fatal: not a git repository	git init을 하지 않은 폴더	프로젝트 폴더에서 git init 실행
remote origin already exists	이미 주소가 연결됨	git remote set-url origin 새주소
Authentication failed	로그인·인증 실패	브라우저 로그인 재시도 또는 개인용 액세스 토큰 사용
rejected (non-fast-forward)	GitHub에 내 컴퓨터에 없는 변경이 있음	git pull 후 다시 push
nothing to commit	변경된 파일이 없음	정상 상태, 수정 후 다시 시도

GitHub는 비밀번호 방식 인증을 중단하고, 브라우저 로그인이나 개인용 액세스 토큰(PAT)을 사용하도록 하고 있습니다. 푸시할 때 비밀번호를 물어도 계정 비밀번호가 통하지 않는 이유입니다.

명령어가 어렵다면: GUI 도구 쓰기

터미널이 부담스럽다면 마우스로 할 수 있는 도구도 있습니다.

• VS Code 소스 제어 탭: 왼쪽의 분기 아이콘에서 변경 파일 확인, 메시지 입력 후 커밋·푸시
• GitHub Desktop: 공식 무료 프로그램으로 가장 초보자 친화적

다만 명령어 몇 개는 알아두는 것이 문제가 생겼을 때 훨씬 도움이 됩니다.

자주 묻는 질문 (FAQ)

Q1. GitHub는 유료인가요?

개인 사용은 무료로 충분합니다. 비공개(Private) 저장소도 무료 계정에서 만들 수 있습니다.

Q2. 커밋 메시지는 어떻게 쓰나요?

"무엇을 바꿨는지"를 짧게 쓰면 됩니다. 예: "메인 페이지 이미지 추가", "댓글 오류 수정". 나중에 기록을 볼 때 큰 도움이 됩니다.

Q3. push를 잘못했어요. 되돌릴 수 있나요?

가능은 하지만 초보자에게는 어려울 수 있습니다. 중요한 작업 전에는 항상 커밋을 자주 남기고, 모르는 상황에서는 무리하게 강제 푸시(--force)를 하지 마세요.

Q4. 비전공자도 꼭 배워야 하나요?

코드를 만든다면 강력히 권합니다. 백업, 되돌리기, 자동 배포까지 한 번에 해결되기 때문입니다.

마치며: 오늘의 3줄 정리

1. Git은 기록 도구, GitHub는 인터넷 보관소다.
2. 수정할 때마다 add → commit → push를 반복한다.
3. 비밀 키(.env)는 절대 올리지 않는다.

처음에는 명령어가 낯설지만 열 번만 반복하면 손에 익습니다. 오늘 작은 프로젝트 하나를 만들어 GitHub에 올려보세요. 그 순간부터 내 코드가 안전하게 보관되는 개발자의 첫걸음이 시작됩니다.