정보

Git Bash를 활용한 GitHub 프로젝트 업로드 완벽 가이드

mindlab091909 2025. 5. 7. 23:07
반응형

 

개발 공부를 시작한 지 얼마 되지 않은 초보자에게 Git과 GitHub는 막막하게 느껴질 수 있습니다. "도대체 Git은 뭐고, GitHub는 또 왜 필요한 거지?"라는 의문부터, "내 컴퓨터에 있는 프로젝트를 GitHub에 어떻게 올리는 거야?"라는 실무적인 질문까지, 누구나 겪는 과정입니다.

이 글에서는 Git Bash를 활용해 내 프로젝트를 GitHub에 업로드하는 전체 과정을 아주 쉽게 설명드립니다. Git 설치가 되어 있다는 가정하에, GitHub에서 원격 저장소 생성부터 git push까지의 흐름을 단계별로 따라가 보세요.

📌 목차

  1. Git과 GitHub 간단 이해
  2. 전체 업로드 흐름 요약
  3. GitHub에 원격 저장소 생성
  4. 내 컴퓨터에 로컬 저장소 생성
  5. 로컬 저장소와 원격 저장소 연결
  6. 로컬 프로젝트 파일 GitHub에 업로드하기
  7. 자주 묻는 질문 (FAQ)
  8. 마무리 및 팁

1. Git과 GitHub 간단 이해

  • Git은 분산 버전 관리 시스템입니다. 여러 명이 협업하거나, 혼자 작업할 때에도 파일의 변경 이력을 효과적으로 관리할 수 있습니다.
  • GitHub는 Git 저장소를 웹에 업로드하고 공유할 수 있는 플랫폼입니다. 오픈소스 프로젝트뿐 아니라 개인 포트폴리오 관리, 협업 등에 필수적으로 사용됩니다.

정리하면, Git은 도구, GitHub는 저장소를 올려두는 공간이라고 보면 됩니다.

2. 전체 업로드 흐름 요약

프로젝트를 GitHub에 올리기 위해서는 다음 5단계를 거칩니다.

  1. GitHub에 원격 저장소(repository) 생성
  2. 내 컴퓨터에 로컬 저장소 생성
  3. 로컬 저장소와 원격 저장소 연결
  4. 파일 스테이징 및 커밋
  5. GitHub에 푸시(push)

이제 각 단계를 하나씩 자세히 살펴보겠습니다.

3. GitHub에 원격 저장소 생성

  1. https://github.com 에 접속하여 로그인 혹은 회원가입합니다.
  2. 상단 메뉴 중 Repositories 탭으로 이동합니다.
  3. 우측의 New 버튼 클릭 → 새 저장소 생성 페이지로 이동합니다.
  4. 저장소 이름을 입력합니다. (my-first-project, portfolio-site 등)
  5. 필요시 설명을 추가하고, "Add a README file" 옵션은 필요에 따라 선택합니다.
  6. "Create repository" 버튼을 눌러 저장소 생성을 완료합니다.

✅ 저장소가 만들어지면 주소창에 보이는 URL(예: https://github.com/username/project-name.git)을 기억해둡니다. 이 주소가 원격 저장소 주소입니다.

4. 내 컴퓨터에 로컬 저장소 생성

이제 내 컴퓨터에서 Git 프로젝트를 준비합니다.

1) Git Bash 실행

  • 내 프로젝트 폴더에서 마우스 우클릭 → Git Bash Here 클릭
  • 만약 Windows 11에서 보이지 않는다면 → '추가 옵션 표시'를 통해 Git Bash 실행

2) 로컬 저장소 초기화

$ git init
  • 해당 폴더에 .git이라는 숨김 폴더가 생기면 성공입니다.

5. 로컬 저장소와 원격 저장소 연결

1) 원격 저장소 주소 확인

GitHub에서 방금 만든 저장소의 주소를 복사합니다. 예:
https://github.com/username/my-first-project.git

2) 연결 명령어 입력

$ git remote add origin https://github.com/username/my-first-project.git

🔄 연결을 확인하려면:

$ git remote -v

3) 연결 삭제(선택 사항)

  • 잘못 연결했거나 재설정하려면:
$ git remote rm origin

6. 로컬 프로젝트 파일 GitHub에 업로드하기

이제 본격적으로 내 프로젝트를 GitHub에 업로드하는 과정입니다. 3단계: add → commit → push 로 진행합니다.

1) add - 스테이지 영역에 파일 올리기

$ git add .
  • 현재 디렉토리의 모든 변경사항을 스테이지 영역에 추가합니다.
  • 특정 파일만 올리고 싶다면:
$ git add index.html

2) commit - 스테이지 → 로컬 저장소로 반영

$ git commit -m "처음 커밋합니다."
  • 커밋 메시지는 현재 변경 사항을 잘 설명하는 문장으로 입력합니다.

3) push - 로컬 저장소 → 원격 저장소로 업로드

$ git push origin main

⚠️ 오류 발생 시: "error: src refspec main does not match"
→ 브랜치명이 main이 아니라 master일 수 있습니다.

$ git branch -M main
$ git push -u origin main
  • 최초 푸시 시 -u 옵션으로 기본 브랜치를 설정해줍니다.

7. 자주 묻는 질문 (FAQ)

Q1. 로컬에 Git이 설치되어 있는지 확인하는 방법은?

$ git --version

버전 정보가 출력된다면 설치되어 있는 것입니다.

Q2. add한 파일을 다시 빼고 싶을 때는?

$ git reset HEAD [파일명]

Q3. 변경사항 없이 커밋하려고 하면 어떤 메시지가 뜨나요?

"nothing to commit, working tree clean"

→ 현재 변경사항이 없다는 의미로 정상입니다.

Q4. 깃허브에서 업로드된 파일이 보이지 않아요

  • 푸시(push) 후에도 파일이 보이지 않는다면 브랜치명이 다르거나 푸시가 실패한 경우입니다.
  • 아래 명령어로 상태를 확인하세요.
$ git status
$ git remote -v

8. 마무리 및 팁

지금까지 Git Bash를 활용해 내 프로젝트를 GitHub에 업로드하는 과정을 단계별로 정리해보았습니다. 사실 Git은 익숙해지면 어렵지 않지만, 처음엔 add, commit, push의 개념도 낯설 수 있습니다. 하지만 직접 여러 번 해보면서 손에 익히는 것이 가장 좋은 방법입니다.

🎁 팁:

  • Git 작업은 자주 commit하고 push하는 습관을 들이세요.
  • GitHub는 단순한 백업용 툴이 아닙니다. 포트폴리오, 협업, 오픈소스 참여 등 다양한 기회로 연결됩니다.

 

반응형