GitHub 팀 프로젝트 준비 가이드 (팀장 버전)
1. Git 설치
- Git 공식 홈페이지 에 접속해 Git을 다운로드합니다.
- 설치가 완료되면 터미널(또는 파워쉘)에서 다음 명령어로 설치 확인을 합니다.
git --version✅ 버전 정보가 출력되면 설치 완료입니다.
2. GitHub 계정 만들기
- GitHub 가입 링크 에서 계정을 생성합니다.
- 로그인합니다.
✅ GitHub 계정이 있어야 저장소를 만들 수 있습니다.
3. 로컬 폴더 준비
-
바탕화면 등 편한 위치에 새 폴더를 하나 생성합니다.
(예:team-project) -
VS Code나 터미널에서 해당 폴더로 이동합니다.
cd 바탕화면\team-project(윈도우 기준)
✅ 이 폴더 안에서 프로젝트를 시작합니다.
4. Git 초기화
- 폴더 안에서 Git 저장소를 초기화합니다.
git init✅ 이 명령어를 입력하면 폴더 안에 .git 숨김 폴더가 생성됩니다.
5. Git 사용자 정보 설정 (최초 1회만)
처음 Git을 사용할 때 이름과 이메일을 설정합니다.
git config --global user.name "내 이름"
git config --global user.email "내 이메일주소@example.com"✅ 이 정보는 커밋 기록에 남습니다.
6. GitHub 저장소 만들기
- GitHub 접속 → 오른쪽 위
+버튼 →New repository클릭 - 저장소 이름 입력 (예:
team-project) - Public(공개) 또는 Private(비공개) 선택
- 초기화 옵션은 체크하지 말 것 (README 파일 추가 ❌)
Create repository클릭
✅ 깡통 저장소가 생성됩니다.
7. 로컬 폴더와 GitHub 저장소 연결
-
방금 만든 GitHub 저장소 주소를 복사합니다. (HTTPS 주소)
-
파워쉘(터미널)에서 아래 명령어 입력
git remote add origin https://github.com/본인아이디/저장소이름.git예시:
git remote add origin https://github.com/GD000908/team-project.git✅ 이제 로컬 폴더와 GitHub 저장소가 연결되었습니다.
8. 프로젝트 파일 생성
- 로컬 폴더 안에 파일 하나 생성합니다.
(예:index.html)
<!-- index.html 내용 예시 -->
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Team Project</title>
</head>
<body>
<h1>Hello Team!</h1>
</body>
</html>✅ 프로젝트에 필요한 파일들을 추가합니다.
9. Git에 파일 추가 및 커밋
- 모든 파일을 Git에 추가합니다.
git add .- 커밋을 합니다. (메시지는 자유롭게)
git commit -m "First commit: 프로젝트 초기 설정"✅ 이 단계에서 로컬에 커밋이 저장됩니다.
10. GitHub로 첫 푸시 (Push)
- 브랜치 이름을
main으로 통일합니다. (권장)
git branch -M main- GitHub 저장소에 처음으로 파일을 업로드합니다.
git push -u origin main✅ 깃허브 저장소에 프로젝트 파일이 올라가게 됩니다.
11. (선택) main 브랜치 보호 설정 (강력 추천)
팀원이 실수로 main 브랜치를 수정하지 못하게 하려면 브랜치 보호 설정을 합니다.
-
GitHub 저장소 →
Settings→Branches -
Add branch protection rule클릭 -
Branch name pattern에main입력 -
아래 체크
- ✅ Require a pull request before merging
- ✅ (선택) Require approvals (리뷰 승인 필수)
-
Save
✅ 이제 main 브랜치는 Pull Request 없이 직접 수정할 수 없습니다.
요약: 팀장 초반 준비 흐름
| 단계 | 명령어/행동 |
|---|---|
| Git 설치 및 확인 | git --version |
| 폴더 생성 및 이동 | cd 폴더경로 |
| Git 초기화 | git init |
| 사용자 설정 | git config --global user.name / user.email |
| GitHub 저장소 생성 | (GitHub 웹사이트에서) |
| 원격 저장소 연결 | git remote add origin URL |
| 파일 생성 | index.html 등 |
| 파일 추가 및 커밋 | git add ., git commit -m "메시지" |
| 브랜치 변경 및 푸시 | git branch -M main, git push -u origin main |
| (선택) 브랜치 보호 | (GitHub Settings에서 설정) |
마무리
이 과정을 완료하면,
✅ 로컬 폴더 ↔️ GitHub 저장소 연결 완료
✅ 프로젝트 첫 버전 업로드 완료
✅ 팀원들이 clone하고 같이 작업할 준비 완료
참고
- git 명령어는 터미널(또는 파워쉘)에서 입력합니다.
- 오류 발생 시 에러 메시지를 보고 하나씩 해결해 나가면 됩니다.
- GitHub는 저장소 URL이 HTTPS로 시작하는 걸 권장합니다.
개인 공부 노트