Git과 GitHub 사용법

작성자

카테고리:

1. Git과 GitHub란 무엇인가요?

프로그래밍을 배우다 보면 코드를 수정하거나 새로운 기능을 추가하는 과정에서 이전 버전으로 돌아가야 할 때가 있습니다. 파일을 여러 개 복사해 두면 어떤 파일이 최신인지 헷갈리고, 다른 사람과 함께 작업할 때는 변경 내용을 관리하기도 어렵습니다.

이런 문제를 해결하는 데 도움을 주는 도구가 바로 Git과 GitHub입니다.

Git이란?

Git은 파일의 변경 이력을 기록하고 관리하는 버전 관리 시스템입니다. 주로 프로그램 코드나 웹사이트 파일을 관리하는 데 사용합니다.

예를 들어 웹사이트를 만들다가 새로운 기능을 추가했는데 문제가 발생했다면, Git에 기록해 둔 이전 버전을 확인하거나 복구할 수 있습니다.

Git의 주요 기능은 다음과 같습니다.

  • 파일의 변경 이력 기록
  • 이전 버전 확인 및 복구
  • 여러 작업 버전 관리
  • 여러 개발자의 작업 내용 통합
  • 변경 사항 비교

GitHub란?

GitHub는 Git으로 관리하는 프로젝트를 인터넷에 저장하고 다른 사람과 공유할 수 있는 온라인 플랫폼입니다.

프로젝트를 GitHub에 올리면 여러 기기에서 작업을 이어 가거나 다른 개발자와 협업할 수 있습니다. 오픈소스 프로젝트를 공개하고 다른 사람의 코드를 살펴보는 데도 활용됩니다.

2. Git과 GitHub의 차이점

Git

내 컴퓨터에서 사용하는 버전 관리 도구

코드 변경 내용을 기록하고, 이전 버전을 확인하며, 작업 이력을 관리합니다.

GitHub

온라인에서 프로젝트를 저장하고 협업하는 플랫폼

저장소를 공유하고, 다른 사람과 코드 변경 사항을 검토하며, 프로젝트를 함께 관리합니다.

쉽게 비유하면 Git은 문서의 수정 기록을 관리하는 도구이고, GitHub는 그 문서와 기록을 온라인에서 공유하는 공간이라고 생각하면 됩니다.

중요한 점: Git은 GitHub 없이도 사용할 수 있습니다. 반대로 GitHub에서 프로젝트를 관리할 때는 일반적으로 Git을 함께 사용합니다.

3. Git을 설치하는 방법

Git을 사용하려면 먼저 공식 사이트에서 설치 프로그램을 내려받아야 합니다.

Git 공식 홈페이지

Windows, macOS, Linux용 설치 파일 제공

Git 공식 사이트 바로가기⁠

Windows에서 설치하기

  • Git 공식 홈페이지에 접속합니다.
  • Windows용 설치 파일을 내려받습니다.
  • 설치 파일을 실행합니다.
  • 특별한 설정이 필요 없다면 기본 설정을 유지하고 설치를 진행합니다.
  • 설치가 완료되면 시작 메뉴에서 Git Bash를 실행합니다.

Git Bash는 Git 명령어를 입력할 수 있는 터미널 프로그램입니다.

macOS에서 설치하기

macOS에서는 터미널을 열고 다음 명령어를 입력할 수 있습니다.

git –version

Git이 설치되어 있으면 버전 정보가 표시됩니다. 설치되어 있지 않다면 개발자 도구 설치 안내가 나타날 수 있습니다. 안내에 따라 설치를 진행하거나 공식 설치 안내를 확인합니다.

설치 확인하기

다음 명령어를 입력합니다.

git –version

예를 들어 git version 2.x.x와 같은 결과가 표시되면 Git을 실행할 수 있는 상태입니다. 표시되는 실제 버전 번호는 설치 환경에 따라 다릅니다.

4. GitHub 계정 만들기

GitHub를 사용하려면 계정을 만들면 됩니다.

GitHub 공식 홈페이지

GitHub 접속하기⁠

계정을 만든 뒤 저장소를 생성할 수 있습니다.

계정 생성은 다음 순서로 진행합니다.

  • GitHub 공식 홈페이지에 접속합니다.
  • 회원 가입 메뉴를 선택합니다.
  • 이메일 주소와 비밀번호 등 필요한 정보를 입력합니다.
  • 이메일 인증 등 안내된 절차를 완료합니다.
  • 로그인한 뒤 사용자 프로필을 확인합니다.

GitHub에서는 프로젝트를 저장소(repository 또는 repo) 단위로 관리합니다. 저장소는 프로젝트 파일과 변경 이력을 모아 두는 공간입니다.

5. Git의 기본 명령어 10가지

Git은 터미널에 명령어를 입력해 사용할 수 있습니다. 처음부터 모든 명령어를 외울 필요는 없습니다. 다음 명령어부터 익히면 기본적인 프로젝트 관리가 가능합니다.

명령어기능
git –versionGit 버전 확인
git config사용자 설정
git init현재 폴더를 Git 저장소로 초기화
git status파일 변경 상태 확인
git add변경 파일을 커밋 준비 영역에 추가
git commit변경 내용을 기록
git branch브랜치 확인 및 관리
git clone원격 저장소 복제
git push로컬 변경 내용을 원격 저장소에 전송
git pull원격 저장소 변경 내용을 가져와 통합

사용자 이름과 이메일 설정

Git에서 커밋을 기록하기 전에 사용자 이름과 이메일을 설정하는 것이 좋습니다.

git config –global user.name “Your Name”

git config –global user.email “you@example.com”

위의 이름과 이메일은 예시입니다. 자신의 정보로 바꾸어 입력하세요. 커밋에 기록되는 이메일을 공개하고 싶지 않다면 GitHub의 이메일 공개 설정을 확인하고 제공되는 비공개 이메일 옵션을 이용할 수 있습니다.

변경 사항 기록하기

가장 자주 사용하는 기본 흐름은 다음과 같습니다.

git status

git add .

git commit -m “첫 번째 변경 사항 기록”

각 명령어의 의미는 다음과 같습니다.

  • git status: 어떤 파일이 변경되었는지 확인합니다.
  • git add .: 현재 폴더의 변경 파일을 커밋 준비 영역에 추가합니다.
  • git commit -m “…”: 준비된 변경 사항을 설명과 함께 기록합니다.

git add .는 현재 폴더의 여러 변경 파일을 한꺼번에 추가하므로, 실행 전에 git status로 민감한 파일이 포함되지 않았는지 확인하는 습관이 중요합니다.

6. 실제 프로젝트를 GitHub에 업로드하기

이제 간단한 프로젝트를 만들어 Git으로 관리하고 GitHub에 업로드해 보겠습니다.

예제로 my-first-project라는 폴더에 텍스트 파일 하나를 만들어 사용하겠습니다.

1단계: 프로젝트 폴더 만들기

컴퓨터에 my-first-project라는 새 폴더를 만듭니다. 폴더 안에 README.md라는 파일을 만들고 다음 내용을 입력합니다.

# My First Project

Git과 GitHub를 배우기 위한 첫 번째 프로젝트입니다.

README.md는 프로젝트가 무엇인지 설명하는 문서입니다. GitHub 저장소 첫 화면에 프로젝트 소개를 표시하는 데 자주 사용됩니다.

2단계: 터미널에서 폴더 열기

터미널 또는 Git Bash를 실행하고 방금 만든 폴더로 이동합니다.

cd my-first-project

명령어를 실행할 때는 실제 폴더 위치에 맞게 경로를 수정해야 합니다.

3단계: Git 저장소 초기화하기

다음 명령어를 입력합니다.

git init

이 명령어를 실행하면 해당 폴더에서 Git으로 변경 이력을 관리할 수 있게 됩니다.

4단계: 파일을 커밋하기

다음 명령어를 순서대로 실행합니다.

git status

git add README.md

git commit -m “Add README”

이제 README.md 파일의 현재 상태가 첫 번째 커밋으로 기록됩니다.

5단계: GitHub에서 저장소 만들기

  • GitHub에 로그인합니다.
  • 새 저장소를 만드는 메뉴를 선택합니다.
  • 저장소 이름에 my-first-project를 입력합니다.
  • 공개 또는 비공개 저장소를 선택합니다.
  • 저장소를 생성합니다.

처음부터 로컬 프로젝트를 올릴 예정이라면 GitHub에서 README.md, .gitignore, 라이선스 파일을 자동 생성하는 옵션은 선택하지 않는 편이 초기 설정 충돌을 피하는 데 도움이 됩니다.

6단계: 로컬 프로젝트와 GitHub 연결하기

GitHub에서 새 저장소를 만든 뒤 표시되는 저장소 주소를 복사합니다. 다음 명령어에서 주소 부분을 자신의 저장소 주소로 바꿉니다.

git remote add origin https://github.com/YOUR-USERNAME/my-first-project.git

git branch -M main

git push -u origin main

명령어의 의미는 다음과 같습니다.

  • git remote add origin …: GitHub 저장소를 원격 저장소 origin으로 등록합니다.
  • git branch -M main: 현재 브랜치의 이름을 main으로 설정합니다.
  • git push -u origin main: 로컬의 main 브랜치를 GitHub에 업로드하고 추적 관계를 설정합니다.

YOUR-USERNAME은 자신의 GitHub 사용자 이름으로 바꿔야 합니다. 인증 화면이 표시되면 GitHub가 안내하는 로그인 또는 인증 절차를 따르세요. 계정 비밀번호를 명령어에 직접 입력하는 방식은 사용하지 않는 것이 좋습니다.

7단계: 업로드 결과 확인하기

GitHub 웹사이트에서 해당 저장소를 새로고침합니다. README.md 파일이 보이면 업로드가 완료된 것입니다.

이제 첫 번째 GitHub 프로젝트를 만들었습니다. 앞으로 파일을 수정할 때는 git add, git commit, git push를 사용해 변경 사항을 기록하고 온라인 저장소에 반영할 수 있습니다.

7. GitHub에서 자주 사용하는 기능

브랜치(Branch)

기존 코드에 직접 영향을 주지 않고 새로운 기능을 개발하기 위한 별도의 작업 흐름입니다. 예를 들어 main 브랜치와 feature-login 브랜치를 나누어 로그인 기능을 개발할 수 있습니다.

풀 리퀘스트(Pull Request)

브랜치에서 변경한 내용을 다른 브랜치에 합치기 전에 검토하고 논의하는 기능입니다. 협업할 때 코드 리뷰에 자주 사용됩니다.

이슈(Issues)

오류, 개선 사항, 새로운 기능 등의 작업을 등록하고 진행 상황을 관리하는 기능입니다.

git clone

과

git pull

의 차이

다른 사람의 프로젝트를 처음으로 내 컴퓨터에 가져올 때는 일반적으로 git clone을 사용합니다.

git clone https://github.com/USERNAME/REPOSITORY.git

이미 복제한 프로젝트에서 원격 저장소의 최신 변경 내용을 가져와 통합할 때는 git pull을 사용합니다.

git pull

반대로 내 컴퓨터의 커밋을 GitHub에 올릴 때는 git push를 사용합니다.

  • clone: 저장소를 처음 복제
  • pull: 원격 변경 내용을 가져와 통합
  • push: 로컬 커밋을 원격 저장소에 전송

8. Git과 GitHub를 사용할 때 주의할 점

Git과 GitHub는 편리하지만, 잘못 사용하면 코드가 사라지거나 중요한 정보가 공개될 수 있습니다.

첫째, 비밀번호와 API 키를 업로드하지 마세요. 프로젝트 파일에 API 키, 비밀번호, 개인 액세스 토큰 등이 포함되어 있는지 확인해야 합니다. .gitignore 파일로 특정 파일이 추적되지 않도록 설정할 수 있지만, 이미 커밋한 파일을 .gitignore에 추가하는 것만으로 과거 기록에서 해당 정보가 삭제되지는 않습니다. 민감한 정보가 노출되었다면 해당 키를 즉시 폐기하거나 교체하고, 필요하면 Git 기록 정리 절차도 진행해야 합니다.

둘째, 공개 저장소와 비공개 저장소를 구분하세요. 공개 저장소는 다른 사람이 코드를 볼 수 있으므로 공개해도 되는 파일만 올려야 합니다. 비공개 저장소도 접근 권한을 가진 사용자에게는 내용이 보일 수 있으므로 보안 관리가 필요합니다.

셋째, 커밋 전에 변경 사항을 확인하세요. git status와 git diff를 사용하면 커밋 전에 변경된 파일과 내용을 확인할 수 있습니다.

git status

git diff

넷째, 의미 있는 커밋 메시지를 작성하세요. 수정처럼 모호한 메시지보다 Fix login form validation 또는 Add homepage navigation처럼 변경 내용을 구체적으로 설명하는 메시지가 좋습니다.

9. 초보자가 자주 겪는 문제와 해결 방법

문제해결 방법
git 명령어를 찾을 수 없다는 오류Git 설치 여부와 터미널의 실행 경로를 확인합니다.
커밋할 때 사용자 정보 오류가 발생함git config로 이름과 이메일을 설정합니다.
remote origin already exists 오류git remote -v로 등록 상태를 확인합니다. 기존 주소를 바꾸려면 git remote set-url origin 저장소주소를 사용합니다.
rejected 또는 non-fast-forward 오류원격 저장소에 별도 커밋이 있는지 확인하고, 필요한 변경을 먼저 통합합니다.
GitHub 인증이 실패함브라우저 로그인이나 지원되는 인증 방식을 확인합니다. 일반 계정 비밀번호를 Git 작업에 그대로 사용하는 방식은 피합니다.
파일이 GitHub에 올라가지 않음커밋 여부, 현재 브랜치, 원격 주소와 git push 결과를 확인합니다.

오류가 발생하면 명령어를 무작정 반복하기보다 오류 메시지를 먼저 읽는 것이 좋습니다. 특히 git push –force와 같은 강제 변경 명령은 다른 사람의 작업을 덮어쓸 수 있으므로 원인을 확인하기 전에는 사용하지 않는 편이 안전합니다.

10. Git과 GitHub를 배우는 7일 학습 계획

처음부터 모든 기능을 익힐 필요는 없습니다. 하루 15~30분씩 아래 순서로 연습하면 기본 사용법을 익히는 데 도움이 됩니다.

0/7 완료

1일 차 — Git 설치 및 버전 확인

git –version

2일 차 — Git 사용자 이름과 이메일 설정

git config –global user.name

3일 차 — 폴더를 Git 저장소로 초기화

git init

4일 차 — 파일 추가 및 커밋 기록

git add README.md

5일 차 — GitHub 계정과 저장소 만들기

GitHub에서 새 저장소 생성

6일 차 — 로컬 프로젝트를 GitHub에 업로드

git push -u origin main

7일 차 — 파일 수정 후 두 번째 커밋 만들기

git status → git add → git commit → git push

체크 초기화

11. Git과 GitHub를 배울 때 도움이 되는 공식 자료

공식 문서를 참고하면서 직접 명령어를 실행해 보는 것이 가장 효과적인 학습 방법입니다.

12. 자주 묻는 질문(FAQ)

Q1. Git과 GitHub는 무료인가요?

Git은 무료로 사용할 수 있는 오픈소스 소프트웨어입니다. GitHub도 무료 요금제를 제공하며, 유료 요금제에서는 추가 기능과 사용 한도를 제공합니다. 구체적인 제공 범위는 요금제에 따라 달라질 수 있습니다.

Q2. 프로그래밍을 몰라도 GitHub를 사용할 수 있나요?

네. 프로그래밍을 아직 배우지 않았더라도 문서, 학습 자료, 개인 프로젝트 파일 등을 관리하는 데 활용할 수 있습니다. 다만 Git 명령어와 기본 개념을 익히면 훨씬 편리하게 사용할 수 있습니다.

Q3. Git과 GitHub를 반드시 함께 사용해야 하나요?

아닙니다. Git은 인터넷 연결 없이도 로컬 컴퓨터에서 사용할 수 있습니다. GitHub는 프로젝트를 온라인에서 저장하고 공유하거나 협업할 때 유용합니다.

Q4. GitHub에 코드를 올리면 누구나 볼 수 있나요?

저장소의 공개 범위에 따라 다릅니다. 공개 저장소는 일반적으로 누구나 볼 수 있고, 비공개 저장소는 권한이 있는 사용자만 접근할 수 있습니다. 저장소 공개 범위와 별개로 비밀번호나 인증 키 같은 민감한 정보는 올리지 않아야 합니다.

Q5. GitHub를 취업 준비에 활용할 수 있나요?

네. 개인 프로젝트와 학습 결과를 정리해 포트폴리오로 활용할 수 있습니다. 프로젝트 설명, 실행 방법, 본인이 담당한 작업, 해결한 문제 등을 README에 구체적으로 작성하면 다른 사람이 프로젝트를 이해하는 데 도움이 됩니다.

코멘트

답글 남기기

이메일 주소는 공개되지 않습니다. 필수 필드는 *로 표시됩니다

광고 차단 알림

광고 클릭 제한을 초과하여 광고가 차단되었습니다.

단시간에 반복적인 광고 클릭은 시스템에 의해 감지되며, IP가 수집되어 사이트 관리자가 확인 가능합니다.