초보자를 위한 Git 및 GitHub 가이드: 설치부터 첫 푸시까지

Source: Dev.to

LUXDevHQ에서 데이터 사이언스, 분석, AI 분야를 시작하는 것은 집을 짓는 동시에 새로운 언어를 배우는 것과 같았습니다. 그 과정에서 제가 발견한 가장 중요한 도구는 버전 관리입니다.

이 가이드에서는 다음을 단계별로 안내합니다:

• Git Bash 설정
• Git을 GitHub에 연결
• 필수 push와 pull 명령 마스터

Git이란 무엇이며 왜 중요한가?

Git은 버전 관리 시스템 (VCS) 입니다. 코드를 위한 저장 지점 시스템이라고 생각하면 됩니다.

Git이 중요한 이유

• ⏪ 시간 여행 – 코드를 망가뜨렸을 때, 작동하던 버전으로 되돌릴 수 있습니다.
• 🤝 협업 – 여러 사람이 같은 프로젝트에서 작업해도 서로의 작업을 덮어쓰지 않습니다.
• 🧪 실험 – 브랜치를 만들어 새로운 기능을 시도할 수 있으며 메인 프로젝트에 영향을 주지 않습니다.

환경 설정

단계 A: Git Bash 설치

1. Git에 접속하여 OS에 맞는 Git을 다운로드합니다 (Windows, macOS, Linux).
2. 설치 프로그램을 실행합니다.

   💡 팁: 대부분의 옵션은 기본 설정을 그대로 두어도 됩니다.

3. 설치가 끝난 후 Git Bash를 엽니다 (터미널 창처럼 보입니다).

단계 B: 사용자 정보 설정

GitHub가 코드를 업로드하는 사람을 알 수 있도록 전역 Git 설정을 구성합니다:

git config --global user.name "Your Name"
git config --global user.email your-email@example.com

연결 보안: SSH 키 설정

1단계: SSH 키 생성

Git Bash를 열고 다음을 실행하세요 (GitHub 이메일로 교체):

ssh-keygen -t ed25519 -C your_email@example.com

• 파일 위치: 기본값(~/.ssh/id_ed25519)을 사용하려면 Enter를 누르세요.
• 암호구문: 편의를 위해 비워두어도 되며, 보안을 강화하려면 설정할 수 있습니다.

2단계: SSH 에이전트에 키 추가

eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

3단계: 공개 키를 GitHub에 추가

공개 키를 클립보드에 복사하세요:

cat ~/.ssh/id_ed25519.pub

그런 다음:

1. GitHub → Settings → SSH and GPG keys → New SSH key 로 이동합니다.
2. 이름을 지정하고(예: “My Learning Laptop”) Key 입력란에 키를 붙여넣습니다.

4단계: 연결 테스트

ssh -T git@github.com

Hi <username>! You've successfully authenticated 메시지가 보이면 준비가 완료된 것입니다!

탐색 및 프로젝트 생성

Git Bash를 사용하여 탐색하는 것이 마우스를 사용하는 것보다 빠릅니다. 다음 명령을 실행하여 첫 번째 저장소를 만드세요:

pwd                     # Print Working Directory
cd Desktop              # Go to Desktop
mkdir my-first-repo     # Create folder
cd my-first-repo        # Enter folder

변경 사항 추적 (핵심 워크플로우)

프로젝트 폴더 안에서 다음을 실행합니다:

git init                         # Start tracking the folder
git status                       # See what Git notices
git add .                        # Stage all changes
git commit -m "My first commit"  # Create a save point

GitHub에 코드 푸시하기

단계 A: GitHub.com에서 저장소 만들기

1. GitHub에 로그인하고 + 아이콘을 클릭 → New repository를 선택합니다.
2. 저장소 이름을 지정합니다(예: my-first-project) 그리고 Public(공개)으로 유지합니다.
3. 충돌을 방지하기 위해 “Add a README”(README 추가) 옵션을 체크하지 않은 상태로 둡니다.
4. Create repository(저장소 만들기)를 클릭합니다.

단계 B: 연결하고 푸시하기

GitHub 설정 페이지에서 SSH URL을 복사합니다(예: git@github.com:your-username/repo-name.git) 그리고 다음 명령을 실행합니다:

git remote add origin git@github.com:your-username/repo-name.git
git push -u origin main

GitHub에서 코드 가져오기

다른 컴퓨터에서 작업하는 경우, 다음 명령으로 최신 업데이트를 다운로드하세요:

git pull origin main

계속 학습을 위한 리소스

• 공식 Git 문서
• GitHub Skills: 인터랙티브 코스
• Git 명령 시각화 (게임)

결론

축하합니다! 이제 전문적인 개발 워크플로우를 설정하셨습니다. Git은 처음에 까다로울 수 있지만, 연습하면 두 번째 본능이 됩니다. 문제가 발생하면 자유롭게 댓글을 달고 서로 도와주세요!