이번 글에서는 Visual Studio Code(VS Code)에서 작업 중인 프로젝트를 GitHub 저장소와 연동하는 방법에 대해 알아보겠다.
프로젝트를 GitHub와 연결하면 버전 관리가 가능하며, 변경 사항을 손쉽게 업로드(Push)하고 다른 환경에서도 이어서 작업할 수 있다.
이번 예제에서는 이미 프로젝트가 존재하는 상태에서 GitHub 저장소와 연결하는 방법을 기준으로 설명한다.
시작하기 전 준비사항
연동을 진행하기 전에 아래 사항이 준비되어 있어야 한다.
- Git 설치
- GitHub 계정 및 GitHub 저장소 생성
- VS Code 설치
Git 설치 방법과 GitHub 저장소 생성 방법은 아래 글을 참고하면 된다.
▶ Git 설치 방법 및 초기 설정하기(Windows 11 기준)
▶ GitHub 회원가입 및 저장소(Repository) 생성하기
만약 VS Code 설치가 필요하면 아래 글을 참고하자.
▶ 비주얼 스튜디오 코드(Visual Studio Code) 소개 및 설치
1. 프로젝트 열기
VS Code를 실행한 후 File → Open Folder를 선택하여 GitHub와 연결할 프로젝트를 연다.
2. Git 저장소 초기화
아직 Git 저장소가 아니라면 프로젝트를 Git 저장소로 초기화해야 한다.
방법 1. Source Control 이용
좌측 Source Control 메뉴를 선택한 후 Initialize Repository를 클릭한다.
(이미지)
방법 2. 터미널 이용
터미널을 열고 다음 명령어를 실행한다.
git init
프로젝트에 .git 폴더가 생성되면 Git 저장소로 초기화가 완료된다.
3. 변경 파일 Commit 하기
최초 Git 저장소로 초기화가 완료되었다면 터미널에서 프로젝트 파일을 Git에 등록한다.
git add .
git add . 명령어를 사용하면 현재 프로젝트 폴더 안의 변경된 파일과 새로 추가된 파일을 한 번에 스테이징할 수 있다.
단, .gitignore에 등록된 파일이나 폴더는 제외된다.
그다음 Commit을 진행한다.
git commit -m "first commit"
또한 터미널 이외에도 Source Control에서 변경 파일을 확인한 후 Commit을 수행할 수 있다.
변경 파일을 선택하면 우측에 변경 전과 변경 후 소스가 함께 보여 비교하기 좋다.
커밋 버튼을 누르면 우측에 커밋 에디트 메시지 창이 뜨며 변경사항에 대한 내용을 기록할 수 있다.
변경 내용을 기록 한 뒤 하단 커밋 버튼을 누르면 git에 변경 분이 Git 저장소에 기록된다.
변경된 파일이 없다면 아래의 명령어를 실행해도 다음과 같은 메시지가 출력되며 새로운 커밋은 생성되지 않는다.
git commit -m "수정"
nothing to commit, working tree clean
즉, 파일을 수정한 경우에만 git add → git commit → git push 순서로 진행하면 된다.
4. GitHub 저장소 연결하기
GitHub에서 생성한 저장소를 원격 저장소(origin)로 등록한다.
git branch -M main
git remote add origin https://github.com/사용자명/저장소명.git
git branch -M main은 현재 브랜치 이름을 main으로 변경하는 명령어이다.
GitHub에서는 기본 브랜치 이름으로 main을 사용하는 경우가 많기 때문에, 로컬 브랜치 이름도 동일하게 맞춰 주기 위해 사용한다.
git remote add origin https://github.com/사용자명/저장소명.git은 로컬 Git 저장소와 GitHub 원격 저장소를 연결하는 명령어이다.
- origin : 원격 저장소의 기본 이름
- https://github.com/사용자명/저장소명.git : 연결할 GitHub 저장소 주소
연결 여부는 아래 명령어로 확인할 수 있다.
git remote -v
정상적으로 연결되면 Fetch와 Push 주소가 표시된다.
5. GitHub에 업로드(Push)
프로젝트를 GitHub에 업로드한다.
git push -u origin main
처음 Push를 수행하는 경우 GitHub 로그인을 요청할 수 있다.
브라우저가 열리면 로그인 및 인증을 완료하면 된다.
업로드가 완료되면 GitHub 저장소에서 프로젝트 파일을 확인할 수 있다.
최초에는 위와 같이 진행해 준다.
이후에는 어떻게 사용할까?
프로젝트가 한 번 GitHub와 연결되면 다시 연동할 필요는 없다.
다음부터는 프로젝트를 VS Code에서 열기만 하면 Source Control이 자동으로 Git 저장소를 인식한다.
일반적인 작업 순서는 다음과 같다.
- 프로젝트 열기
- 파일 수정
- Source Control에서 변경 사항 확인
- Commit
- Push 또는 Sync Changes
즉, 최초 한 번만 GitHub와 연결하면 이후부터는 Commit과 Push만으로 버전 관리를 계속할 수 있다.
자주 발생하는 오류
remote origin already exists
이미 GitHub 저장소가 등록되어 있는 경우 발생한다.
현재 등록된 원격 저장소를 확인한다.
git remote -v
기존 저장소를 변경하려면 다음 명령어를 실행한다.
git remote set-url origin https://github.com/사용자명/저장소명.git
기존 연결을 삭제한 후 다시 등록하려면 를 다음 명령어를 실행하면 된다.
git remote remove origin
git remote add origin https://github.com/사용자명/저장소명.git
마치며
이번 글에서는 VS Code에서 기존 프로젝트를 GitHub 저장소와 연동하는 방법을 알아보았다.
프로젝트와 GitHub를 한 번 연결해 두면 이후에는 VS Code의 Source Control에서 Commit과 Push만으로 손쉽게 버전 관리를 진행할 수 있다.
다음 글에서는 VS Code에서 GitHub 저장소를 Clone 하는 방법과 Source Control의 Sync Changes 사용법에 대해 알아보겠다.
'개발노트' 카테고리의 다른 글
| PuTTY SSH 서버 접속 방법 (0) | 2026.07.11 |
|---|---|
| 원격 SSH 프로그램 PuTTY 소개 및 사용 방법 (0) | 2026.07.10 |
| Git 기본 명령어(init, add, commit, pull, push, clone) 사용법 (0) | 2026.06.29 |
| Git 프로젝트 GitHub 업로드(Push) 방법 (0) | 2026.06.29 |
| Git이란? GitHub와 차이점 알아보기 (0) | 2026.06.28 |
