VS Code에서 GitHub 연결하는 방법 (초보자 완전 정리)

VS Code에서 GitHub 연결하는 방법 (초보자 완전 정리)

개발을 시작하면 반드시 필요한 것이 바로 GitHub 연동입니다.
이번 글에서는 Visual Studio Code(VS Code)에서 GitHub를 연결하는 방법을 초보자 기준으로 하나씩 설명드리겠습니다.

---

1. 사전 준비

먼저 아래 3가지는 반드시 준비되어 있어야 합니다.

• GitHub 계정
• Git 설치
• VS Code 설치

Git 설치 여부 확인:

git --version

---

2. VS Code에서 GitHub 로그인

1. VS Code 실행
2. 왼쪽 Source Control (Ctrl + Shift + G) 클릭
3. Sign in to GitHub 선택
4. 브라우저에서 로그인 후 승인

👉 로그인 완료되면 VS Code와 GitHub 계정이 연결됩니다.

---

3. GitHub 저장소 가져오기 (Clone)

Ctrl + Shift + P → Git: Clone

저장소 주소 입력:

https://github.com/사용자이름/저장소.git

폴더 선택 후 프로젝트 열기

---

4. 내 프로젝트를 GitHub에 올리는 방법

1) Git 초기화

git init

2) 파일 추가

git add .

3) 커밋

git commit -m "first commit"

4) 원격 저장소 연결

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

5) Push

git branch -M main
git push -u origin main

---

5. HTTPS vs SSH 차이

HTTPS 방식

• 초보자에게 가장 쉬움
• 로그인 필요 (PAT 사용)

SSH 방식

• 한 번 설정하면 편함
• 비밀번호 입력 없음

---

6. 자주 발생하는 오류

❌ git 명령어 안됨

👉 Git 미설치 또는 PATH 문제

❌ authentication failed

👉 GitHub 비밀번호 대신 PAT 사용 필요

❌ remote origin already exists

git remote set-url origin 주소

❌ src refspec main 오류

👉 커밋이 없는 상태

---

7. 추천 사용 흐름

git init
git add .
git commit -m "init"
git branch -M main
git remote add origin 저장소주소
git push -u origin main

---

마무리

VS Code와 GitHub 연결은 개발의 시작이라고 할 수 있습니다.
처음에는 어렵게 느껴질 수 있지만, 한 번 익숙해지면 매우 편리하게 사용할 수 있습니다.

앞으로는 commit → push → 관리 흐름으로 프로젝트를 관리해보세요 👍