내 코드를 클라우드로, 깃(Git)에 프로젝트 소스 올리는 법

내 코드를 클라우드로, 깃(Git)에 프로젝트 소스 올리는 법

작성한 소스 코드를 깃허브(GitHub)와 같은 원격 저장소에 올리는 과정은 개발자에게 필수적인 워크플로우입니다. 크게 내 컴퓨터에 깃 저장소를 만드는 단계와 이를 온라인 저장소에 연결하는 단계로 나뉩니다.

---

1. 깃 초기 설정 및 로컬 저장소 생성

먼저 내 프로젝트 폴더를 깃이 추적할 수 있는 상태로 만들어야 합니다. 터미널(또는 CMD)에서 프로젝트 폴더로 이동한 뒤 아래 명령어를 차례로 입력합니다.

• git init: 현재 폴더를 깃 저장소로 초기화합니다. .git이라는 숨겨진 폴더가 생기며 이때부터 버전 관리가 시작됩니다.
• git add .: 폴더 내의 모든 변경된 파일을 스테이징 영역(Staging Area)에 올립니다. '점(.)'은 모든 파일을 의미합니다.
• git commit -m "메시지": 스테이징 영역에 있는 파일들을 스냅샷으로 찍어 저장소에 기록합니다.

---

2. 원격 저장소(GitHub) 연결 및 업로드

로컬에서 기록한 내용을 이제 온라인(GitHub 등)으로 보낼 차례입니다. 깃허브에서 새로운 저장소(Repository)를 먼저 생성한 후 해당 URL을 복사해 두세요.

• git remote add origin [URL]: 내 로컬 저장소와 온라인 저장소를 연결합니다. 'origin'은 원격 저장소의 별칭입니다.
• git branch -M main: 기본 브랜치 이름을 main으로 변경합니다. (최신 깃 표준)
• git push -u origin main: 로컬의 기록을 원격 저장소로 업로드합니다. -u 옵션은 이후에 git push만 입력해도 되도록 설정을 기억하는 역할을 합니다.

---

한눈에 정리하는 깃 업로드 5단계

단계	명령어	역할
준비	git init	깃 저장소 만들기
선택	git add .	올릴 파일들 선택하기
기록	git commit -m "first commit"	내 컴퓨터에 저장하기
연결	git remote add origin [주소]	온라인 저장소와 연결하기
전송	git push origin main	온라인으로 파일 밀어넣기

---

주의해야 할 사항: .gitignore 활용

프로젝트를 올릴 때 가상환경(venv), 설정 파일(.env), 혹은 컴파일된 결과물(__pycache__) 등은 깃에 올리지 않는 것이 원칙입니다. 이를 위해 .gitignore라는 파일을 만들어 제외할 목록을 적어주어야 합니다.

• 생성 방법: 프로젝트 루트 폴더에 .gitignore 파일을 만들고 제외할 폴더나 파일명을 입력합니다.
• 효과: git add .을 실행해도 해당 목록에 있는 파일들은 무시되므로 저장소를 깔끔하게 유지할 수 있습니다.

---

실전 팁: 이미 연결된 주소 확인하기

만약 내 프로젝트가 어디로 연결되어 있는지 확인하고 싶거나, 주소를 잘못 입력했다면 아래 명령어를 사용하세요.

• 주소 확인: git remote -v
• 주소 변경: git remote set-url origin [새로운 URL]