Git·GitHub 입문 가이드 | add·commit·push부터 브랜치 관리까지 초보자도 쉽게 이해하기

테스트 자동화 코드를 작성하기 시작하면 다음으로 필요한 것이 Git과 GitHub에 대한 지식입니다. 버전 관리·팀 공유·CI/CD 연동 모두 Git을 중심으로 돌아갑니다. 명령어를 한 줄씩 확인하면서, 처음 배워야 할 조작을 정리합니다.

📌 이 글의 대상 독자

📖 이 글을 읽으면 할 수 있는 것

필자는 여러 프로젝트에서 Python × Selenium·Playwright·pytest를 사용한 테스트 자동화 코드를 Git으로 관리하고, GitHub Actions와 연동해 왔습니다.
이 글에서는 “명령어는 외웠는데 무엇을 하는지 모르겠다”는 초보자가 막히기 쉬운 포인트를 미리 짚어서 설명합니다.

Git과 GitHub는 무엇이 다른가

먼저 헷갈리기 쉬운 점을 정리합니다.

Git 없이는 GitHub를 사용할 수 없습니다.
먼저 Git을 설치해 로컬에서 이력 관리를 익힌 다음 GitHub에 연결하는 순서로 진행합니다.

① Git 설치

Windows의 경우

브라우저에서 git-scm.com/download/win에 접속해 인스톨러를 다운로드·실행합니다.
설정은 기본적으로 디폴트로 두어도 문제없습니다. “Choosing the default editor used by Git”에서 “Use Visual Studio Code”를 선택하면 나중에 편리합니다.

Mac의 경우

Mac에는 Git이 처음부터 설치되어 있는 경우가 많습니다. 터미널에서 확인합니다.

git --version

버전이 표시되면 OK입니다. 설치되어 있지 않은 경우는 Homebrew로 설치합니다.

brew install git

② Git 초기 설정

Git을 설치했으면 먼저 이름과 이메일 주소를 설정합니다. 이것은 커밋(변경 기록)에 “누가 변경했는가”를 연결하기 위한 설정으로, 한 번만 하면 됩니다.

# 이름 설정 (GitHub 사용자명과 맞추면 알기 쉬움)
git config --global user.name "Your Name"

# 이메일 주소 설정 (GitHub에 등록한 주소)
git config --global user.email "your@email.com"

# 설정 확인
git config --list

③ 기본 워크플로우: add → commit → push

Git의 일상적인 조작은 이 3단계로 이루어집니다.

실제 절차

1. 저장소(repository) 만들기 (최초 1회)

# 프로젝트 폴더로 이동
cd my-test-project

# Git 저장소 초기화
git init

git init을 실행하면 폴더 안에 .git이라는 숨김 폴더가 생성됩니다. 이것이 Git의 이력 데이터베이스입니다.

2. 현재 상태 확인

git status

git status는 “지금 무엇이 바뀌었는지”를 확인하는 명령어입니다. 헷갈릴 때는 일단 git status. 작업 중에 몇 번이든 실행할 수 있습니다.

3. 파일 스테이징(add)

# 파일을 개별 추가 (처음에는 하나씩 확인하면서 하는 것이 안심)
git add test_sample.py

# 모든 파일을 한 번에 추가 (익숙해지면)
git add .

4. 변경 기록(commit)

# -m으로 커밋 메시지 작성
git commit -m "add: login test"

5. GitHub에 push (최초)

GitHub에서 저장소를 만든 후(github.com에 로그인 → “New repository”에서 생성), 다음 명령어로 연결합니다.

# GitHub 저장소를 origin으로 등록 (URL은 자신의 저장소에 맞게)
git remote add origin https://github.com/yourusername/my-test-project.git

# 현재 브랜치명 확인
git branch
# → "main"이 표시되면 OK
# → "master"가 표시된 경우 아래 명령어로 main으로 변경
git branch -M main

# main 브랜치를 GitHub에 push
git push -u origin main

2회째 이후는 git push만으로 OK입니다.

④ .gitignore로 불필요한 파일 제외하기

.gitignore는 “Git으로 관리하지 않을 파일·폴더”를 지정하는 파일입니다.
테스트 자동화 프로젝트에서 반드시 제외해야 하는 것이 있습니다.

프로젝트 루트에 .gitignore 파일을 만들어 다음을 붙여넣습니다.

# .gitignore (테스트 자동화 프로젝트용)

# ⚠️ 환경 변수·기밀 정보 (최우선 제외)
.env
.env.*
*.secret

# 가상 환경
venv/
.venv/

# Python 캐시
__pycache__/
*.py[cod]
*.pyo

# pytest
.pytest_cache/
.coverage
htmlcov/

# 로그
*.log

# OS 생성 파일
.DS_Store        # Mac
Thumbs.db        # Windows

# Allure 리포트
allure-results/
allure-report/

# IDE 설정 (팀에서 공유 불필요)
.vscode/
.idea/

⑤ 브랜치를 사용해 안전하게 변경 가하기

브랜치란 메인 코드를 건드리지 않고 변경을 시도할 수 있는 “작업용 복사본”입니다.
테스트 자동화 코드를 추가·변경할 때는 반드시 브랜치를 만들어 작업합니다.

# 현재 브랜치 확인
git branch

# 새 브랜치를 만들고 이동 (Git 2.23 이상 권장 방법)
git switch -c feature/add-login-test
# 구버전 Git에서는: git checkout -b feature/add-login-test

# 작업·add·commit (일반 조작)
git add .
git commit -m "add: login validation test for valid credentials"

# GitHub에 브랜치 push
git push -u origin feature/add-login-test

# 작업 완료 후 main으로 돌아가 머지 (로컬 머지의 경우)
git checkout main
git merge feature/add-login-test

브랜치명에는 feature/(새 기능)나 fix/(버그 수정) 접두사를 붙이면 무엇을 위한 변경인지 알기 쉬워집니다.

⑥ 자주 쓰는 명령어 빠른 참조

⑦ 다음 단계: GitHub Actions로 CI/CD 실행하기

Git과 GitHub의 기본을 익혔다면, 다음은 GitHub Actions를 사용해 pytest를 자동 실행할 수 있습니다.
코드를 push할 때마다 테스트가 자동으로 돌아가는 환경은 테스트 자동화의 묘미 중 하나입니다.

# GitHub Actions 설정 파일을 두는 위치
.github/
└── workflows/
    └── test.yml   ← 이 YAML 파일로 CI를 정의

실무에서 자주 막히는 포인트

자주 묻는 질문 (FAQ)

정리

Git 조작을 익히면 테스트 자동화 코드 관리가 훨씬 수월해집니다. 다음 단계로 GitHub Actions로 push할 때마다 pytest를 자동 실행하는 환경을 만들어 보세요. 그것이 테스트 자동화의 본래 모습입니다.

처음에는 명령어가 많아서 힘들게 느껴질 수 있지만, status → add → commit → push의 흐름을 매일 반복하다 보면 자연스럽게 몸에 익습니다.