개발자의 필수품 깃허브(GitHub) 완벽 가이드: 회원가입부터 저장소 생성까지
여러분은 프로그래밍을 공부하면서 이런 생각 해본 적 있나요? “내가 작성한 코드를 어디에 저장해야 하지?” 또는 “실수로 코드를 잘못 수정했는데, 이전 버전으로 돌아갈 수 없을까?”
바로 이럴 때 필요한 게 GitHub(깃허브)입니다. GitHub는 전 세계 개발자들이 사용하는 코드 저장소이자 협업 플랫폼이에요. 프로그래밍을 배우는 사람이라면 반드시 알아야 할 도구입니다.
이 글에서는 GitHub가 처음이신 분들을 위해 회원가입부터 첫 번째 저장소 생성까지, 스크린샷과 함께 정말 자세하게 설명해드릴게요.
GitHub가 뭐예요? Git과 뭐가 다른가요?
많은 초보자들이 Git과 GitHub를 헷갈려해요. 간단히 정리하면:
Git과 GitHub의 차이 – Git은 도구, GitHub는 서비스
쉽게 비유하면:
Git은 워드프로세서(한글, MS Word) 같은 프로그램이고, GitHub는 구글 드라이브나 네이버 클라우드 같은 저장 공간이에요. Git으로 작업한 내용을 GitHub에 올려서 백업하고, 다른 사람들과 공유할 수 있어요.
GitHub, 왜 꼭 필요한가요?
제가 파이썬을 배우기 시작했을 때, 이런 일들이 있었어요:
🚨 실제 겪었던 문제들
1 코드를 잘못 수정해서 프로그램이 작동 안 함
어제까지 잘 돌아가던 코드를 수정했는데 에러 투성이가 됐어요. 이전 버전으로 돌아가고 싶은데 방법이 없었죠.
2 파일명이 이렇게 됨: 코드_최종_진짜최종_final_real.py
버전 관리를 파일명으로 하다 보니 어떤 게 최신인지 헷갈렸어요.
3 노트북이 고장나서 모든 코드 날아감
1주일 동안 작성한 프로젝트 코드가 한순간에 사라졌어요. 백업을 안 해뒀거든요.
GitHub를 사용하면 이런 문제가 모두 해결돼요!
| 문제 | GitHub 해결책 |
|---|---|
| 실수로 코드 망침 | 언제든지 이전 버전으로 복구 가능 |
| 파일명 관리 복잡 | 자동으로 버전 관리됨 |
| 컴퓨터 고장 시 코드 손실 | 클라우드에 안전하게 백업 |
| 협업 어려움 | 여러 명이 동시에 작업 가능 |
| 포트폴리오 정리 | 깔끔한 프로필 페이지 제공 |
GitHub 회원가입하기 (5분 완성)
자, 이제 본격적으로 시작해볼까요? GitHub 회원가입은 정말 간단해요.
단계 1: GitHub 웹사이트 접속
웹브라우저(크롬, 엣지 등)를 열고 주소창에 github.com을 입력하세요.
GitHub 홈페이지 – Sign up 버튼 클릭
단계 2: 이메일 주소 입력
첫 화면에서 이메일 주소를 입력하라고 나와요. 자주 사용하는 이메일을 입력하세요.
단계 3: 비밀번호 & 사용자 이름 설정
다음 단계에서 입력해야 할 것들:
비밀번호: 최소 15자 이상, 또는 8자 이상 + 숫자 + 특수문자 조합
사용자 이름(Username): 이게 중요해요! 이 이름이 여러분의 GitHub 주소가 됩니다.
• 나중에 이력서에 쓸 거라면 본명이나 전문적인 이름 사용
• 영문 소문자, 숫자, 하이픈(-)만 사용 가능
• 한 번 정하면 변경이 어려우니 신중하게!
단계 4: 로봇 아님 확인
“Are you a robot?” 질문에 간단한 퍼즐을 풀면 돼요. 화살표나 동물 찾기 같은 거예요.
단계 5: 이메일 인증
입력한 이메일로 6자리 인증 코드가 옵니다. 코드를 입력하면 회원가입 완료!
첫 번째 저장소(Repository) 만들기
이제 본격적으로 코드를 저장할 공간을 만들어봅시다. GitHub에서는 이걸 저장소(Repository, 줄여서 Repo)라고 불러요.
저장소란?
저장소는 하나의 프로젝트를 담는 폴더라고 생각하면 돼요. 예를 들어:
- my-first-python-project 저장소: 파이썬 기초 학습 코드 모음
- calculator-app 저장소: 계산기 프로그램 프로젝트
- blog-website 저장소: 블로그 웹사이트 코드
각 저장소는 독립적으로 관리되며, README 파일, 라이선스, 코드 파일 등을 포함할 수 있어요.
저장소 생성 단계별 가이드
1 로그인 후 오른쪽 상단 “+” 버튼 클릭
GitHub에 로그인하면 화면 오른쪽 위에 프로필 사진 옆에 + 버튼이 있어요. 클릭하면 “New repository” 메뉴가 나옵니다.
오른쪽 상단 + 버튼 → New repository 클릭
2 저장소 이름 입력
“Repository name” 칸에 원하는 이름을 입력하세요. 규칙은:
- 영문 소문자, 숫자, 하이픈(-), 언더스코어(_) 사용 가능
- 공백 불가 (띄어쓰기 대신 하이픈 사용)
- 의미 있는 이름으로 (나중에 찾기 쉽게)
3 공개(Public) vs 비공개(Private) 선택
| 구분 | Public (공개) | Private (비공개) |
|---|---|---|
| 누가 볼 수 있나요? | 전 세계 누구나 | 나와 초대한 사람만 |
| 검색 가능? | 네, 구글에서도 검색됨 | 아니요 |
| 언제 사용? | 포트폴리오, 오픈소스 | 연습용, 회사 프로젝트 |
| 무료? | 무제한 무료 | 무제한 무료 (개인 계정) |
4 README 파일 추가 (선택, 하지만 강력 권장!)
“Add a README file” 체크박스가 있어요. 이거 꼭 체크하세요!
README가 뭐예요?
프로젝트를 설명하는 안내 문서예요. 방문자가 저장소에 들어왔을 때 제일 먼저 보는 페이지입니다.
5 .gitignore 추가 (선택)
.gitignore 파일은 “이 파일들은 GitHub에 올리지 마!”라고 지정하는 거예요. 파이썬 프로젝트라면 “Python” 템플릿을 선택하세요.
• __pycache__ 폴더 (자동 생성되는 캐시)
• .env 파일 (비밀번호 같은 민감 정보)
• 가상환경 폴더 (venv)
→ 이런 파일들은 GitHub에 올릴 필요가 없어요!
6 “Create repository” 버튼 클릭!
모든 설정이 끝났으면 초록색 버튼을 클릭하세요. 짜잔! 🎉 여러분의 첫 번째 GitHub 저장소가 만들어졌어요!
저장소에 파일 업로드하기 (웹에서 바로)
저장소를 만들었으니 이제 파일을 올려볼까요? 처음엔 웹 브라우저에서 직접 올리는 게 가장 쉬워요.
방법 1: 직접 드래그 앤 드롭
1 저장소 페이지에서 “Add file” 버튼 클릭
2 “Upload files” 선택
3 컴퓨터에서 파일을 드래그해서 박스 안에 놓기
4 커밋 메시지 입력 (뭘 올렸는지 간단히 설명)
5 “Commit changes” 버튼 클릭
파일 업로드 화면 – 드래그 앤 드롭으로 쉽게 올리기
• hello.py (간단한 파이썬 코드)
• README.md (프로젝트 설명)
• requirements.txt (사용한 라이브러리 목록)
초보자가 자주 하는 실수와 해결법
실수 1: 저장소 이름에 한글 사용
증상: 한글로 저장소 이름을 만들었는데 나중에 Git 명령어 쓸 때 오류 발생
해결: 저장소 설정(Settings)에서 이름을 영문으로 변경하세요. 단, URL이 바뀌니 주의!
실수 2: Public 저장소에 비밀번호 올림
증상: 데이터베이스 비밀번호나 API 키를 코드에 직접 적어서 올렸더니 해킹 시도 메일이 와요!
해결: 즉시 저장소를 Private으로 전환하고, 비밀번호는 .env 파일에 분리해서 .gitignore에 추가하세요.
• 비밀번호, API 키를 코드에 직접 작성
• 개인정보 (주민등록번호, 전화번호 등) 업로드
• 회사 기밀 정보 Public 저장소에 올리기
실수 3: 커밋 메시지를 대충 씀
나쁜 예: “수정”, “ㅇㅇ”, “asdf”
좋은 예: “로그인 기능 추가”, “버그 수정: 이메일 형식 검증”
나중에 히스토리를 볼 때 무엇을 변경했는지 알 수 있어야 해요!
실수 4: README 파일 안 만듦
저장소에 코드만 있고 설명이 없으면 다른 사람이 이해하기 어려워요. 미래의 내 자신도 기억 못 해요!
최소한 포함할 내용:
- 프로젝트 제목
- 무엇을 하는 프로그램인지
- 어떻게 실행하는지
GitHub 기본 용어 정리
| 용어 | 의미 | 예시 |
|---|---|---|
| Repository (저장소) | 프로젝트를 담는 공간 | my-first-project |
| Commit (커밋) | 변경사항 저장 | “버그 수정 완료” |
| Push (푸시) | 내 컴퓨터 → GitHub 업로드 | 로컬 코드를 GitHub에 올림 |
| Pull (풀) | GitHub → 내 컴퓨터 다운로드 | 최신 버전 받아오기 |
| Clone (클론) | 저장소 전체를 복사 | 다른 사람 프로젝트 복사 |
| Fork (포크) | 다른 사람 저장소를 내 계정으로 복사 | 오픈소스 기여할 때 |
| Branch (브랜치) | 평행세계처럼 독립적인 작업 공간 | main, develop, feature |
| README | 프로젝트 설명 문서 | README.md |
다음 단계: 뭘 배워야 할까요?
여러분은 이제 GitHub 계정도 만들고, 첫 번째 저장소도 생성했어요! 🎉
다음으로 추천하는 학습 순서:
1 Git 명령어 익히기 (git add, git commit, git push)
웹에서 하는 것도 좋지만, 명령어를 알면 훨씬 효율적이에요.
2 VS Code와 GitHub 연동
VS Code에서 직접 커밋하고 푸시할 수 있어요.
3 브랜치 사용법
메인 코드를 건드리지 않고 새 기능을 실험할 수 있어요.
4 협업하기
Pull Request, Issue 등 팀 프로젝트에 필요한 기능들
• 매일 공부한 코드를 GitHub에 올리기 (습관 만들기)
• README를 점점 더 멋지게 꾸미기 (마크다운 문법 배우기)
• 다른 사람의 오픈소스 프로젝트 구경하기 (검색: python beginner projects)
자주 묻는 질문 (FAQ)
Q1. GitHub는 무료인가요?
A. 네! 개인 사용자는 Public/Private 저장소 모두 무제한 무료예요. 팀 기능이나 고급 기능만 유료입니다.
Q2. 저장소는 몇 개까지 만들 수 있나요?
A. 무제한이에요! 프로젝트마다 하나씩 만들어도 괜찮아요.
Q3. Private 저장소를 나중에 Public으로 바꿀 수 있나요?
A. 네! 저장소 설정(Settings) → Danger Zone에서 언제든 변경 가능해요. 반대로도 가능하고요.
Q4. 실수로 민감한 정보를 올렸어요!
A. 즉시 저장소를 Private으로 전환하고, 해당 커밋을 삭제하세요. 비밀번호는 바로 변경하세요!
Q5. Git 설치 안 해도 GitHub 사용할 수 있나요?
A. 웹에서 기본 작업은 가능해요. 하지만 본격적으로 개발하려면 Git 설치가 필요해요.
Q6. 회사 프로젝트도 GitHub에 올려도 되나요?
A. 회사 규정을 먼저 확인하세요! 대부분 회사는 Private 저장소나 자체 서버를 사용해요.
마무리: GitHub 사용의 첫걸음을 내디뎠어요!
축하합니다! 🎉 이제 여러분은 전 세계 개발자들이 사용하는 플랫폼의 일원이 되었어요.
GitHub는 단순히 코드를 저장하는 곳이 아니에요. 여러분의 성장 과정을 기록하고, 포트폴리오를 만들고, 다른 개발자들과 소통하는 공간입니다.
처음엔 어색하겠지만, 하루에 한 번씩 커밋하는 습관을 들이면 어느새 GitHub 그래프가 초록색으로 가득 찰 거예요. 그게 바로 여러분이 꾸준히 노력한 증거랍니다.
1. 저장소 하나 만들기
2. README.md 파일 작성하기
3. 오늘 작성한 파이썬 코드 올리기
→ 이 3가지만 해도 여러분은 GitHub 사용자입니다!
다음 시리즈에서는 파이썬 기초 문법 (변수, 조건문, 반복문)을 본격적으로 배워볼 거예요. GitHub에 저장하면서 공부하면 복습도 쉽고, 나중에 포트폴리오로도 활용할 수 있어요.
여러분의 코딩 여정을 응원합니다! 🚀