[Github] Github에 기존 프로젝트 올리기

열심히 코딩해서 만든 내 컴퓨터(로컬) 속의 프로젝트,

어떻게 Github(원격 저장소)에 안전하게 백업하고 공유할 수 있을까요?

오늘은 이미 내 컴퓨터에 작업해 둔 폴더/프로젝트를 Github의 새 레포지토리(Repository)에 올리는 방법을 단계별로 알아보겠습니다.

---

1. Github에서 새 레포지토리(Repository) 만들기

가장 먼저 Github 웹사이트에 접속해서 프로젝트를 담을 그릇을 만들어야 합니다.

1. Github 메인 페이지 우측 상단의 + 버튼을 누르고 [New repository]를 클릭합니다.
   
2. Repository name에 원하는 프로젝트 이름을 입력합니다.
3. 중요: 기존 프로젝트를 올릴 때는 Add a README file, .gitignore, License 등의 체크박스를 모두 해제(체크하지 않음) 하는 것이 좋습니다. (충돌 방지를 위해 빈 저장소로 시작하는 것이 깔끔합니다.)
4. [Create repository] 버튼을 클릭합니다.

생성이 완료되면 HTTPS 주소(https://github.com/아이디/레포지토리명.git)가 보일 텐데, 이 주소를 복사해 둡니다.

---

2. 로컬 프로젝트에서 Git 초기화

이제 내 컴퓨터의 프로젝트 폴더로 이동합니다.

1. 프로젝트 폴더 안에서 우클릭 후 Git Bash Here를 클릭하거나, 터미널(CMD, iTerm 등)을 열어 해당 폴더 경로로 이동합니다.
2. 아래 명령어를 입력하여 현재 폴더를 Git이 관리하는 영역으로 만듭니다.

git init

💡 참고: 명령어가 성공하면 폴더 내에 숨김 파일로 .git 폴더가 생성됩니다.

---

3. 파일을 스테이징하고 커밋하기

이제 프로젝트의 모든 파일을 Git 장바구니(Staging Area)에 담고, 기록(Commit)을 남길 차례입니다.

1) 파일 전체 추가 (Staging)

git add .

• 점(.)은 변경된 모든 파일을 의미합니다.

2) 커밋 메세지 작성 (Commit)

git commit -m "first commit"

• "first commit" 부분에는 원하는 히스토리 메세지를 적으면 됩니다.

---

4. Github 레포지토리와 연결하기

아까 1번 단계에서 복사해 둔 Github 주소를 사용하여 내 컴퓨터와 Github를 연결합니다.

1) 기본 브랜치 이름 변경 (선택 사항이지만 권장)
과거에는 master를 썼지만, 요즘은 main을 기본 브랜치명으로 사용합니다.

git branch -M main

2) 원격 저장소(Github) 연결

git remote add origin [복사한_Github_주소_붙여넣기]

• _예시: `git remote add origin https://github.com/username/my-project.git_`

---

5. Github로 업로드 (Push)

마지막으로 연결된 Github 저장소로 내 코드들을 밀어 넣습니다.

git push -u origin main

이 명령어를 입력하고 잠시 기다리면 업로드가 완료됩니다. (처음 연결 시 Github 로그인 창이 뜰 수 있습니다. 로그인을 진행해 주세요.)

---

✅ 확인하기

이제 Github 웹페이지로 돌아가서 새로고침(F5)을 해보세요. 내 컴퓨터에 있던 파일들이 Github 레포지토리에 예쁘게 올라와 있는 것을 확인할 수 있습니다.

💡 요약 정리

# 1. git 초기화
git init

# 2. 모든 파일 담기
git add .

# 3. 커밋 남기기
git commit -m "프로젝트 업로드"

# 4. 브랜치명 변경 (master -> main)
git branch -M main

# 5. Github 주소 연결
git remote add origin https://github.com/본인ID/레포지토리명.git

# 6. 업로드
git push -u origin main

이제 여러분의 소중한 코드가 Github에 안전하게 저장되었습니다!

---

이 포스팅이 도움이 되셨다면, 좋아요와 댓글 부탁드립니다!