Git 초보 탈출! 🚀 로컬 폴더를 GitHub 원격 저장소에 연결하는 완벽 가이드

안녕하세요! 코딩 여정을 막 시작한 여러분, 혹은 버전 관리가 항상 어렵게 느껴졌던 분들을 위해 준비했습니다. 😮 내 컴퓨터(로컬)에 있는 프로젝트 폴더를 어떻게 GitHub 같은 온라인 공간(원격 저장소)에 연결하고 관리할 수 있을까요?

 

오늘은 Git의 가장 기본적인 세 가지 명령어를 통해 로컬 프로젝트 폴더에 Git의 숨결을 불어넣고, 이미 존재하는 원격 저장소와 연결하여 최신 내용을 가져오는 방법까지 차근차근 알아보겠습니다. 이 글만 따라오시면 더 이상 Git이 두렵지 않을 거예요! 😉

 

 

1단계: 모든 것의 시작 - 내 폴더를 Git 관리 구역으로! 📂

가장 먼저 해야 할 일은 내 컴퓨터의 프로젝트 폴더를 Git이 추적하고 관리할 수 있는 특별한 공간, 즉 '로컬 저장소(Local Repository)'로 만들어주는 것입니다.

마법의 주문은 바로 git init 입니다.

# Git으로 관리하고 싶은 프로젝트 폴더로 이동한 후, 아래 명령어를 입력하세요.
git init

 

이 명령어를 실행하면 무슨 일이 일어날까요?

• ✨ 마법 발생: 현재 폴더 안에 .git 이라는 숨겨진 폴더가 하나 생성됩니다.
• .git 폴더의 정체: 이 폴더는 해당 프로젝트의 모든 변경 이력(버전), 설정 정보 등이 저장되는 Git의 심장과도 같은 곳입니다. 평소에는 보이지 않지만, Git은 이 폴더를 통해 모든 버전 관리 작업을 수행합니다.

이제 여러분의 폴더는 평범한 폴더가 아니라, 시간 여행(버전 관리)을 할 준비가 된 특별한 Git 저장소가 되었습니다! ✅

 

2단계: 다리 놓기 - 로컬과 원격을 연결하기 🔗

이제 내 컴퓨터의 로컬 저장소를 GitHub에 있는 '원격 저장소(Remote Repository)'와 연결해 줄 차례입니다. 원격 저장소는 내 코드의 안전한 백업 공간이자, 다른 사람들과 협업하는 중심점이 되죠.

연결을 위한 다리는 git remote add 명령어로 놓을 수 있습니다.

Bash

 

# git remote add <원격저장소_별명> <원격저장소_URL>
git remote add origin https://github.com/사용자이름/저장소이름.git

명령어가 조금 길어 보이지만, 각 부분의 의미를 알면 간단해요.

• git remote add: "여기에 새로운 원격 저장소 연결을 추가할게!" 라는 뜻입니다.
• origin: 앞으로 우리가 사용할 긴 원격 저장소 URL의 '별명(alias)' 입니다. 매번 긴 주소를 입력하는 건 번거로우니, 보통 'origin'이라는 기본적이고 관례적인 별명을 붙여줍니다. '집', '회사'처럼 주소를 저장하는 것과 같아요.
• https://...git: 연결할 GitHub 저장소의 고유한 주소(URL)입니다.

💡 꿀팁: 연결이 잘 되었는지 확인하고 싶다면 아래 명령어를 사용해 보세요. 내가 추가한 원격 저장소의 별명과 주소를 보여줍니다.

git remote -v

 

자, 이제 내 컴퓨터의 로컬 저장소와 GitHub의 원격 저장소 사이에 튼튼한 다리가 놓였습니다!

3단계: 최신 정보 동기화 - 원격 저장소 내용 가져오기 📥

원격 저장소에 이미 팀원들이 작업한 내용이나 중요한 파일들이 들어있을 수 있습니다. 이 파일들을 내 로컬 저장소로 가져와서 최신 상태로 동기화해야겠죠?

 

이때 사용하는 명령어가 바로 git pull 입니다.

# git pull <원격저장소_별명> <브랜치_이름>
git pull origin main

 

이 명령어는 다음과 같은 일을 수행합니다.

• git pull: "원격 저장소에서 최신 내용을 당겨와!" 라는 의미입니다.
• origin: 2단계에서 우리가 지정한 원격 저장소의 별명입니다. "origin에서 가져와줘!" 라고 알려주는 거죠.
• main: 가져올 내용이 담겨 있는 '가지(branch)'의 이름입니다. Git은 여러 버전의 흐름을 '브랜치'라는 개념으로 관리하는데, 보통 기본 브랜치의 이름은 main 또는 master 입니다.

이 명령어를 실행하면, 원격 저장소(origin)의 main 브랜치에 있는 모든 파일과 변경 이력이 내 로컬 저장소 폴더로 짠! 하고 복사됩니다. 이제 여러분의 로컬 폴더는 원격 저장소와 완전히 동일한 최신 상태가 되었습니다. 🎉

마무리하며

오늘 우리는 Git의 핵심적인 3가지 명령어를 배웠습니다.

1. git init: 내 폴더를 Git 저장소로 초기화하기
2. git remote add: 로컬 저장소와 원격 저장소 연결하기
3. git pull: 원격 저장소의 최신 내용 내려받기

이 세 단계만 확실히 이해해도 Git을 통한 기본적인 버전 관리와 협업의 첫걸음을 뗀 것이나 다름없습니다. 처음에는 낯설 수 있지만, 반복해서 사용하다 보면 금방 익숙해질 거예요. 여러분의 성공적인 코딩 라이프를 응원합니다! 👨‍💻👩‍💻

---

태그: Git, GitHub, 깃, 깃허브, 버전관리, 개발자, 코딩, 원격저장소, Git 기초