📘실용 가이드: Git 소개 + GitHub에 코드 올리는 방법

Source: Dev.to

소개

현재 소프트웨어 개발 환경에서는 수십 가지 언어, 프레임워크, 도구를 사용합니다. 스택에 관계없이 모든 개발자는 초기에 버전 관리에 능숙해져야 합니다.

핵심 도구 두 가지는 다음과 같습니다:

• Git – 전 세계에서 가장 많이 사용되는 버전 관리 시스템.
• GitHub – Git 기반의 호스팅 및 협업 플랫폼.

Git과 GitHub를 연동하는 방법을 보여주기 전에, 왜 이러한 도구가 존재하는지 그리고 내부적으로 어떻게 동작하는지 이해하는 것이 중요합니다. 이 기반은 모든 전문가에게 자신감을 주고 일상적인 실수를 방지합니다.

Git은 Linus Torvalds(리눅스 창시자)가 만든 오픈‑소스 버전 관리 소프트웨어입니다. 원래 동기는 간단했습니다: 커널 버전을 빠르고 효율적이며 신뢰할 수 있게 관리할 시스템이 필요했는데, 당시 도구들은 이를 제공하지 못했기 때문입니다.

Git이 전 세계 표준이 된 이유는 다음과 같습니다:

• 빠름
• 분산형(각 머신이 전체 저장소를 가짐)
• 안전함(해싱 기반)
• 원격 서버와의 동기화가 간단함

Git은 어떻게 동작할까?

과거의 차이점(diff)만 저장하던 시스템과 달리, Git은 스냅샷 전체를 매 커밋마다 저장합니다. 프로젝트의 “사진”을 찍지만, 실제로는 변경된 부분만 해시와 중복 제거를 통해 다시 저장합니다.

각 스냅샷은 커밋이며, 시간 순서대로 이어집니다. 이를 통해 빠르고 안전하며 탐색이 쉬운 히스토리를 제공합니다.

Git은 기본적으로 .git/objects/에 저장되는 불변 객체들의 데이터베이스입니다. 주요 객체 유형은 다음과 같습니다:

1. Blob – 파일 내용.
2. Tree – 디렉터리를 나타내며, Blob 및 다른 Tree를 가리킴.
3. Commit – Tree와 부모 커밋들을 가리킴.
4. Tag – 일반적으로 버전 표시용으로 커밋을 가리키는 마커.

각 객체는 내용의 해시값으로 이름이 지정되어:

• 암호학적 무결성 보장
• 불변 히스토리
• 손상 감지
• 자동 중복 제거

브랜치는 프로젝트 복사가 아니라 커밋을 가리키는 포인터일 뿐입니다. 예를 들어:

main → 메인 라인의 최신 커밋을 가리킴

브랜치를 만들면 새로운 포인터가 생성되고, 해당 브랜치에서 커밋을 하면 포인터가 앞쪽으로 이동합니다. 그래서 브랜치를 만드는 것이 비용이 거의 없으며 적극 권장됩니다.

커밋들은 방향성 비순환 그래프(DAG) 를 형성합니다:

• 각 커밋은 자신의 부모를 가리킴.
• 병합(Merge)은 두 개의 부모를 가짐.
• 히스토리는 항상 앞으로 진행됨.

Git에는 인덱스라는 중간 영역이 있어, 어떤 내용이 커밋에 포함될지 선택할 수 있습니다. 이를 통해 더 깔끔한 커밋, 세밀한 제어, 파일 일부만 커밋하는 것이 가능합니다.

원격 저장소란?

GitHub, GitLab, Bitbucket 같은 서버는 클라우드에 호스팅된 추가 Git 저장소에 불과합니다. 주요 명령은 다음과 같습니다:

• git push → 커밋을 보내고 원격 레퍼런스를 업데이트.
• git pull → 원격 커밋을 받아와 로컬 브랜치를 업데이트.

Merge

• 두 부모를 가진 커밋을 생성.
• 병렬 히스토리를 유지.

Rebase

• 커밋을 재작성하여 부모를 변경.
• 선형 히스토리를 생성.
• 새로운 해시를 생성.

두 방법 모두 현대 개발자의 필수 도구입니다. Git은 기존 커밋을 절대 수정하지 않고 새 커밋을 만들며, 오래된 커밋은 “고아”가 되어 git gc에 의해 정리될 수 있습니다.

이론 요약

• Git은 해시 기반의 불변 데이터베이스.
• 커밋은 스냅샷.
• 브랜치는 포인터.
• 히스토리는 DAG.
• 원격 저장소는 단순히 추가 레퍼런스.

GitHub

GitHub는 전 세계에서 가장 큰 코드 호스팅 플랫폼으로, 수백만 개의 저장소가 존재합니다. 마이크로소프트가 소유하고 있으며 다음을 제공합니다:

• 저장소 호스팅
• issues
• 풀 리퀘스트
• CI/CD 워크플로우(GitHub Actions)
• 팀 협업
• 풍부한 웹 인터페이스
• 데스크톱·모바일 앱

요약하면: Git은 로컬에서 코드를 관리하고, GitHub는 코드를 공유·협업·배포할 수 있게 해줍니다.

단계별 가이드

1. Git 설치

git --version

설치되지 않았다면, 해당 페이지에서 다운로드합니다.

2. 이름과 이메일 설정

git config --global user.name "Seu Nome"
git config --global user.email "seuemail@example.com"

3. 로컬 저장소 만들기

# 프로젝트 디렉터리에서
git init
git add .
git commit -m "primeiro commit"

4. GitHub에 저장소 만들기

1. 페이지에 접속합니다.
2. New repository 클릭.
3. 이름 지정.
4. 초기 파일을 만들지 않도록 선택(첫 푸시 시 충돌 방지).

5. 로컬 저장소를 GitHub와 연결

git remote add origin https://github.com/usuario/repositorio.git

6. 기본 브랜치를 main으로 지정

git branch -M main

7. 프로젝트를 GitHub에 푸시

git push -u origin main

완료! 🎉 이제 프로젝트가 온라인에 올라갔습니다.

주요 작업 흐름

git add .
git commit -m "mensagem"
git pull
git push

흔히 발생하는 문제

1. 푸시 거부

   git pull --rebase origin main

2. 충돌

   • 파일을 열어 충돌을 해결한 뒤:

     git add .
     git commit

3. 인증 실패

   • SSH 키를 설정하거나 GitHub CLI를 통해 로그인합니다.

Cheatsheet (Git 주요 명령)

설정

git config --global user.name
git config --global user.email

초기화

git init

상태와 로그

git status
git log --oneline

스테이징 및 커밋

git add arquivo
git add .
git commit -m "mensagem"

브랜치

git branch
git checkout -b nova-branch
git switch main

Merge & Rebase

git merge nome-branch
git rebase main

원격과 동기화

git remote -v
git push
git pull

저장소 복제

git clone url