데이터 과학자 및 데이터 엔지니어를 위한 Git — 나의 첫 번째 초보자 가이드 (Git Bash + GitHub)

Source: Dev.to

안녕하세요, 저는 Charles Ndungu입니다. 최근에 데이터 사이언스와 분석을 배우기 시작했어요. Git을 한 번도 사용해 본 적은 없지만, Git과 GitHub에 대한 저의 첫 경험을 단계별로 공유하고 싶었습니다. 저와 같은 초보자들이 따라 할 수 있도록 말이죠.

Repo:

TL;DR

Git은 파일에 대한 변경 사항을 추적합니다. GitHub은 추적 중인 프로젝트를 온라인에 저장합니다. 기본 흐름을 배워보세요:

init → add → commit → push → pull

이 정도만 알아도 자신 있게 작업을 시작하고 다른 사람과 작업을 공유할 수 있습니다.

Git이 중요한 이유 (짧게)

• 재현성 – 이전 버전으로 언제든 돌아갈 수 있습니다.
• 협업 – 여러 사람이 서로 덮어쓰지 않고 작업할 수 있습니다.
• 안전성 – 브랜치에서 실험하고 실수를 되돌릴 수 있습니다.
• 전문성 – 데이터 팀에서는 기대되는 표준입니다.

필요 사항

• Windows (이 단계는 Git Bash를 사용합니다) – macOS/Linux 사용자는 Terminal을 사용할 수 있습니다.
• GitHub 계정
• Git Bash가 설치됨
• (옵션) 파일을 편집하기 위한 VS Code

Very simple mental model

Step 1 — Git Bash 설치 (Windows) — 빠르게

1. 공식 사이트에서 다운로드 → Windows 선택.
2. 설치 프로그램 실행 → 기본값을 그대로 사용. 물어보면 OpenSSH 선택.
3. Start → Git → Git Bash에서 Git Bash 열기.

2단계 — 최소 설정 (한 번만)

Git Bash를 열고 다음을 실행합니다:

git --version
git config --global user.name "Your Name"
git config --global user.email "you@example.com"
git config --list

3단계 — 첫 번째 로컬 프로젝트 — 내가 실행한 정확한 명령어

# create project folder and enter it
mkdir ~/git-basics-practice
cd ~/git-basics-practice

# create a tiny file
echo "hello from git bash" > hello.txt

# start Git in this folder
git init

# check status
git status

# track the file
git add hello.txt

# save a snapshot
git commit -m "Add hello.txt"

# check history
git log --oneline

4단계 — GitHub 저장소 만들기 및 푸시 (실제 순간)

1. GitHub에서 + → New repository를 클릭합니다.
2. git-basics-practice 라는 이름을 지정합니다.
3. README 또는 .gitignore를 초기화 하지 마세요.

인증 참고 사항

• GitHub은 이제 명령줄에서 계정 비밀번호를 받지 않습니다. 프롬프트가 표시되면 비밀번호 대신 **Personal Access Token (PAT)**을 사용하세요.
• 또는 SSH 키를 설정하세요 (장기적으로 권장). 공개 키를 GitHub → Settings → SSH and GPG keys에 추가합니다.

로컬 저장소 푸시

git remote add origin https://github.com/your-username/git-basics-practice.git
git branch -M main
git push -u origin main

Troubleshooting — real things I saw (and how to fix)

• fatal: User canceled device code authentication – 브라우저 프롬프트를 닫으면 Git이 사용자 이름/PAT 입력을 요구할 수 있습니다. git push를 다시 실행하고 PAT를 사용하거나 SSH를 설정하세요.
• Permission denied (publickey) – GitHub에 SSH 키가 없습니다. id_ed25519.pub를 GitHub → Settings → SSH keys에 추가하세요.
• 404 – 브라우저에서 저장소를 열 때 발생합니다. 정확한 저장소 이름과 비공개 여부를 확인하세요. 제가 한 번 원격 URL 끝에 . 를 하나 더 넣은 적이 있었는데 (...git-basics-practice..git), 이 때문에 끝에 점이 있는 저장소 이름이 생겨 혼란스러운 404가 발생했습니다. 항상 git remote -v 로 확인하세요.

Step 5 — 변경 사항 가져오기 (다운로드)

누군가 저장소를 수정하거나 GitHub에서 수정한 경우, 다음 명령으로 변경 사항을 내려받을 수 있습니다:

git pull origin main

짧은 요령 시트 (기억할 명령어)

git init                 # start tracking a folder
git status               # see file status
git add                  # stage file
git commit -m "msg"      # save snapshot
git log --oneline        # view history
git remote -v           # show remotes
git push -u origin main # upload commits
git pull origin main    # download commits
git checkout -b name    # create + switch branch

작은 실제 교훈 (내 초보자 순간)

성공적으로 푸시했지만 브라우저에서 내 레포지토리를 열었을 때 404 오류가 발생했습니다. 나중에 원격 URL에 점이 하나 더 들어가 있었음(git-basics-practice..git)을 발견했으며, 그 때문에 레포지토리 이름 끝에 점이 붙었습니다. Git은 여전히 푸시를 받아들였지만, 점이 없는 일반적인 브라우저 링크는 404를 반환했습니다. 404가 발생하면 git remote -v를 실행하고 URL이 정확히 기대한 대로인지 확인하세요.