GitHub 상징 이미지

GitHub 저장소 연결 및 코드 업로드(Git Push)

본 문서는 로컬에서 개발한 프로젝트를 GitHub 저장소에 효율적으로 업로드하고 관리하는 방법, 그리고 Git 인증 시 발생할 수 있는 일반적인 오류 해결 방안을 상세히 안내합니다. 최초 한 번의 설정만으로 이후에는 간결한 명령어를 통해 GitHub와의 연동 및 코드 업로드를 손쉽게 진행할 수 있습니다.

1. Git 사용자 정보 등록 (최초 1회 설정)

Git은 커밋 작성자를 식별하기 위해 사용자 이름과 이메일 정보를 필요로 합니다. 이 설정은 개발 환경 PC당 한 번만 수행하면 영구적으로 적용됩니다.

1-1. 이메일 등록

git config --global user.email "사용자 이메일"

예시

git config --global user.email "example@gmail.com"

1-2. 사용자 이름 등록

git config --global user.name "사용자 이름"

예시

git config --global user.name "Hong Gil Dong"

TIP

등록된 사용자 정보는 다음 명령어를 통해 언제든지 확인할 수 있습니다.

git config --global --list

2. 로컬 저장소 초기화 및 첫 커밋 생성

프로젝트 폴더를 Git 저장소로 초기화하고, 현재 작업 내용을 첫 번째 버전으로 기록합니다.

2-1. Git 저장소 초기화

git init

현재 작업 디렉터리가 Git 저장소로 변환됩니다.

2-2. 변경 파일 스테이징

git add .

현재 디렉터리의 모든 변경된 파일을 커밋 대상으로 등록(스테이징)합니다.

2-3. 첫 번째 커밋 생성

git commit -m "Initial commit"

프로젝트의 현재 상태를 하나의 확정된 버전으로 저장합니다.

3. GitHub 원격 저장소 연결

로컬 Git 저장소와 GitHub 상의 원격 저장소를 연결하는 과정입니다.

3-1. GitHub 저장소 주소 연결

GitHub에서 해당 저장소의 Code → HTTPS 섹션에서 저장소 주소를 복사한 후, 다음 명령어를 실행합니다.

git remote add origin https://github.com/사용자명/저장소명.git

예시

git remote add origin https://github.com/example/my-project.git

3-2. 기본 브랜치를 main으로 설정

git branch -M main

GitHub의 기본 브랜치인 main과 일치시켜 브랜치 충돌 가능성을 최소화하는 것을 권장합니다.

4. 최초 코드 업로드(Push)

로컬 저장소의 내용을 GitHub 원격 저장소로 최초 업로드하는 단계입니다.

git push -u origin main

여기서 -u 옵션은 원격 저장소 'origin'의 'main' 브랜치를 현재 로컬 브랜치의 상위 스트림(upstream)으로 설정하여, 이후부터는 단순히 git push 명령만으로 업로드가 가능하게 합니다.

5. Git 인증 오류 해결 방법 (Windows 환경)

Windows 환경에서 git push 실행 시 인증 창이 나타나지 않고 터미널이 무한 대기 상태가 되는 경우가 발생할 수 있습니다.

증상

  • git push 실행 후 시스템 반응 없음

  • 인증 팝업 창이 나타나지 않음

  • 터미널이 지속적으로 대기 모드 유지

원인

Git Credential Manager의 로그인 창이 백그라운드에 숨겨졌거나, 인증 세션이 정상적으로 연결되지 않을 때 발생합니다.

해결 방법

  1. VS Code 좌측 사이드바에서 Source Control 메뉴를 선택합니다.

  2. Publish Branch 또는 Sync Changes 버튼을 클릭합니다.

  3. VS Code 상단에 표시되는 알림에서 Allow를 선택하여 인증을 허용합니다.

  4. 자동으로 브라우저가 열리면 GitHub 계정으로 로그인 과정을 완료합니다.

  5. 인증이 완료된 후 VS Code로 돌아와 코드 업로드가 정상적으로 완료되었는지 확인합니다.

한 번 성공적으로 인증을 완료하면, 이후부터는 대부분 별도의 로그인 절차 없이 Git 작업을 수행할 수 있습니다.

6. 일상적인 Git 작업 순서

프로젝트 수정 후에는 다음 세 가지 명령어를 반복하여 Git 저장소를 관리합니다.

1단계. 변경 파일 스테이징

git add .

2단계. 변경 내용 커밋

git commit -m "변경한 내용 요약"

예시

git commit -m "로그인 기능 추가 및 버그 수정"

3단계. GitHub에 업로드

git push

정리

최초 설정은 다소 번거롭게 느껴질 수 있지만, 한 번만 완료하면 됩니다. 이후에는 다음 세 가지 필수 Git 명령어만 기억하면 대부분의 버전 관리 작업을 효율적으로 수행할 수 있습니다.

git add .
git commit -m "변경 내용 요약"
git push

이 세 단계의 반복적인 숙달을 통해 프로젝트의 버전 관리와 GitHub를 통한 안전한 코드 백업을 체계적으로 진행할 수 있습니다.