컴퓨터·공학 계열뿐 아니라 문서, 과제, 팀 프로젝트, 포트폴리오를 다루는 모든 학부 신입생을 위한 한국어 GitHub 길잡이입니다.
이 가이드는 "깃허브 계정은 만들었는데 그다음에 뭘 해야 할지 모르겠어요" 하는 분들을 위해 만들어졌습니다. 명령어 몇 줄만 외우는 것이 아니라, 왜 이렇게 하는지를 이해하면서 따라 할 수 있도록 구성했습니다.
- 프로그래밍 수업에서 처음으로 Git/GitHub를 만난 1~2학년 학부생
- 팀 프로젝트에서 코드나 문서를 함께 관리해야 하는 모든 전공 학생
- 과제 백업, 포트폴리오, 공부 기록을 깃허브에 쌓고 싶은 분
이미
git push -u origin main이 무슨 뜻인지 아시는 분이라면, 바로 협업 워크플로우로 넘어가셔도 됩니다.
- 1부 — 기초 설정과 핵심 개념: Git과 GitHub가 무엇인지, 어떻게 설치하고 첫 저장소를 만드는지
- 2부 — 협업 워크플로우: 브랜치, Pull Request, 코드 리뷰, 충돌 해결, Fork 기반 기여, Issue 관리
다루지 않는 내용: GitHub Pages 배포, GitHub Actions(CI/CD), GitHub Student Pack 같은 심화 주제입니다. 기초를 충분히 익히신 뒤 따로 찾아보시면 됩니다.
- 인터넷이 연결된 노트북 (Windows 10/11 또는 macOS)
- GitHub에서 사용할 이메일 주소
- 터미널을 사용할 수 있다는 최소한의 자신감 (없어도 괜찮습니다. 2장에서 같이 시작합니다.)
아래 순서대로 따라오시면 됩니다. 각 장은 약 10~15분 안에 읽고 실습할 수 있는 분량으로 맞추었습니다.
| 순서 | 내용 | 링크 |
|---|---|---|
| 1장 | Git과 GitHub의 차이, 왜 배워야 하나요? | docs/01-git-vs-github.md |
| 2장 | 계정·Git·VS Code·SSH 키 설정하기 | docs/02-setup.md |
| 3장 | 첫 저장소 만들고 clone → commit → push 하기 |
docs/03-first-repo.md |
| 순서 | 내용 | 링크 |
|---|---|---|
| 4장 | 브랜치로 안전하게 일하기 | docs/04-branches.md |
| 5장 | Pull Request와 코드 리뷰 | docs/05-pull-request.md |
| 6장 | 병합 충돌(Merge Conflict) 해결하기 | docs/06-merge-conflicts.md |
| 7장 | Fork와 Upstream으로 기여하기 | docs/07-fork-upstream.md |
| 8장 | 좋은 Issue 작성법 | docs/08-issues.md |
| 내용 | 링크 |
|---|---|
| 명령어 치트시트 + 한영 용어집 | docs/09-cheatsheet.md |
- 순서대로 읽으세요. 뒤 장은 앞 장에서 배운 명령을 전제로 설명합니다.
- 반드시 직접 타이핑해 보세요. 복사-붙여넣기만으로는 손에 익지 않습니다.
- 에러가 나도 당황하지 마세요. 각 장 끝에 "자주 겪는 어려움" 섹션이 있습니다.
- 용어가 헷갈리면 부록의 용어집을 펼쳐 두세요.
```bash블록 안의$로 시작하는 줄은 터미널에서 입력하는 명령입니다.$는 빼고 입력하시면 됩니다.- Windows / macOS 명령이 다를 때는 OS 이름을 제목으로 달아 구분합니다.
backtick안에 있는 단어는 명령어, 파일명, 깃허브 용어입니다.
이 문서는 학습 목적의 자료이며, 오탈자 제보나 설명 개선 제안은 언제든 환영합니다. 문서를 더 낫게 만들고 싶으시다면 8장 docs/08-issues.md 를 읽으신 뒤 Issue나 Pull Request로 의견을 주세요.
그럼, 1장 docs/01-git-vs-github.md 부터 시작해 봅시다. 👋