Git 명령어 사용 가이드

Git은 버전 관리 시스템으로, 프로젝트의 변경 사항을 추적하고 관리하는 데 필수적인 도구입니다. 일상적인 사용에는 몇 가지 핵심 명령어가 중요하지만, 숙련된 사용자라면 더 많은 명령어를 익혀야 합니다. 다음은 자주 사용되는 Git 명령어 목록입니다. 이해를 돕기 위해 몇 가지 용어를 정의합니다.

  • Workspace: 작업 공간 (Working Directory)
  • Index / Stage: 스테이징 영역 (Staging Area)
  • Repository: 저장소 (Local Repository)
  • Remote: 원격 저장소

1. 저장소 생성

새로운 Git 저장소를 초기화하거나 기존 프로젝트를 복제하는 명령어를 포함합니다.


# 현재 디렉토리에 Git 저장소 초기화
$ git init

# 새 디렉토리를 생성하고 Git 저장소로 초기화
$ git init [프로젝트명]

# 원격 저장소의 전체 기록을 다운로드하여 복제
$ git clone [url]
  

2. 설정 관리

Git의 동작 방식을 구성하는 설정을 관리합니다. 설정은 전역 또는 로컬 저장소 단위로 적용될 수 있습니다.


# 현재 Git 설정 확인
$ git config --list

# Git 설정 파일 편집 (전역 또는 로컬)
$ git config -e [--global]

# 커밋 시 사용자 이름 및 이메일 설정
$ git config [--global] user.name "[이름]"
$ git config [--global] user.email "[이메일 주소]"
  

3. 파일 변경 추적

작업 공간의 파일을 스테이징 영역에 추가하거나, 스테이징 영역 또는 작업 공간에서 파일을 제거하는 명령어입니다.


# 지정된 파일을 스테이징 영역에 추가
$ git add [파일1] [파일2] ...

# 지정된 디렉토리를 재귀적으로 스테이징 영역에 추가
$ git add [디렉토리]

# 현재 디렉토리의 모든 변경된 파일을 스테이징 영역에 추가
$ git add .

# 각 변경 사항을 스테이징 전에 확인
$ git add -p

# 작업 공간에서 파일을 삭제하고 스테이징 영역에도 반영
$ git rm [파일1] [파일2] ...

# 파일을 추적 중단 (작업 공간에는 파일 유지)
$ git rm --cached [파일]

# 파일 이름을 변경하고, 변경 사항을 스테이징 영역에 추가
$ git mv [기존파일명] [변경파일명]
  

4. 커밋 생성

스테이징 영역의 변경 사항을 저장소에 기록합니다.


# 스테이징 영역의 변경 사항을 저장소에 커밋 (메시지 포함)
$ git commit -m "[커밋 메시지]"

# 지정된 파일만 스테이징 영역에서 커밋
$ git commit [파일1] [파일2] ... -m "[커밋 메시지]"

# 추적 중인 파일의 모든 변경 사항을 스테이징 없이 바로 커밋
$ git commit -a

# 커밋 시 모든 diff 정보 표시
$ git commit -v

# 이전 커밋을 새로운 커밋으로 대체 (변경 사항이 없을 경우 메시지 수정)
$ git commit --amend -m "[새 커밋 메시지]"

# 이전 커밋을 수정하고, 지정된 파일의 새로운 변경 사항 포함
$ git commit --amend [파일1] [파일2] ...
  

5. 브랜치 관리

독립적인 개발 라인인 브랜치를 생성, 전환, 병합, 삭제하는 명령어입니다.


# 모든 로컬 브랜치 목록 표시
$ git branch

# 모든 원격 브랜치 목록 표시
$ git branch -r

# 모든 로컬 및 원격 브랜치 목록 표시
$ git branch -a

# 새 브랜치 생성 (현재 브랜치 유지)
$ git branch [브랜치명]

# 새 브랜치 생성 및 해당 브랜치로 전환
$ git checkout -b [브랜치명]

# 특정 커밋을 가리키는 새 브랜치 생성
$ git branch [브랜치명] [커밋]

# 지정된 원격 브랜치와 추적 관계를 맺는 새 브랜치 생성
$ git branch --track [브랜치명] [원격브랜치명]

# 지정된 브랜치로 전환하고 작업 공간 업데이트
$ git checkout [브랜치명]

# 이전 브랜치로 전환
$ git checkout -

# 현재 브랜치와 지정된 원격 브랜치 간의 추적 관계 설정
$ git branch --set-upstream [브랜치명] [원격브랜치명]

# 지정된 브랜치를 현재 브랜치로 병합
$ git merge [브랜치명]

# 특정 커밋을 현재 브랜치로 가져와 병합
$ git cherry-pick [커밋]

# 로컬 브랜치 삭제
$ git branch -d [브랜치명]

# 원격 브랜치 삭제
$ git push origin --delete [브랜치명]
$ git branch -dr [원격/브랜치명]
  

6. 태그 관리

릴리스 지점과 같이 중요한 커밋에 고유한 이름을 부여하는 태그를 관리합니다.


# 모든 태그 목록 표시
$ git tag

# 현재 커밋에 새 태그 생성
$ git tag [태그명]

# 특정 커밋에 새 태그 생성
$ git tag [태그명] [커밋]

# 로컬 태그 삭제
$ git tag -d [태그명]

# 원격 태그 삭제
$ git push origin --delete [태그명]
$ git push origin :refs/tags/[태그명]

# 태그 정보 확인
$ git show [태그명]

# 특정 태그를 원격 저장소에 푸시
$ git push [원격지] [태그명]

# 모든 태그를 원격 저장소에 푸시
$ git push [원격지] --tags

# 특정 태그를 가리키는 새 브랜치 생성 및 전환
$ git checkout -b [브랜치명] [태그명]
  

7. 상태 확인

저장소의 현재 상태, 변경 사항, 커밋 기록 등을 조회합니다.


# 변경된 파일 목록 표시
$ git status

# 현재 브랜치의 커밋 기록 표시
$ git log

# 커밋 기록 및 각 커밋에서 변경된 파일 목록 표시
$ git log --stat

# 키워드로 커밋 기록 검색
$ git log -S "[키워드]"

# 특정 커밋 이후의 모든 변경 사항을 한 줄로 표시
$ git log [태그] HEAD --pretty=format:%s

# 특정 커밋 이후의 변경 사항 중, 커밋 메시지가 특정 조건에 맞는 것 검색
$ git log [태그] HEAD --grep [패턴]

# 파일의 버전 기록 표시 (파일 이름 변경 포함)
$ git log --follow [파일]
$ git whatchanged [파일]

# 특정 파일에 대한 모든 diff 표시
$ git log -p [파일]

# 최근 5개 커밋 표시 (간결하게)
$ git log -5 --pretty --oneline

# 커밋 횟수별로 정렬된 모든 커밋 사용자 목록 표시
$ git shortlog -sn

# 특정 파일의 수정자 및 수정 시간 표시
$ git blame [파일]

# 스테이징 영역과 작업 공간 간의 차이 표시
$ git diff

# 스테이징 영역과 마지막 커밋 간의 차이 표시
$ git diff --cached [파일]

# 작업 공간과 현재 브랜치의 최신 커밋 간의 차이 표시
$ git diff HEAD

# 두 브랜치 간의 차이 표시
$ git diff [첫번째브랜치]...[두번째브랜치]

# 오늘 작성한 코드 라인 수 표시
$ git diff --shortstat "@{0 day ago}"

# 특정 커밋의 메타데이터 및 내용 변경 사항 표시
$ git show [커밋]

# 특정 커밋에서 변경된 파일 이름만 표시
$ git show --name-only [커밋]

# 특정 커밋 시점의 특정 파일 내용 표시
$ git show [커밋]:[파일명]

# 현재 브랜치의 최근 커밋 기록 표시 (HEAD 이동 추적)
$ git reflog
  

8. 원격 저장소 연동

로컬 저장소와 원격 저장소 간의 데이터를 주고받습니다.


# 원격 저장소의 모든 변경 사항 다운로드 (병합은 하지 않음)
$ git fetch [원격지]

# 등록된 모든 원격 저장소 목록 표시
$ git remote -v

# 특정 원격 저장소 정보 표시
$ git remote show [원격지]

# 새 원격 저장소 추가 및 이름 지정
$ git remote add [별칭] [url]

# 원격 저장소의 변경 사항을 가져와 현재 브랜치에 병합
$ git pull [원격지] [브랜치]

# 로컬 브랜치를 원격 저장소에 푸시
$ git push [원격지] [브랜치]

# 충돌이 발생하더라도 현재 브랜치를 강제로 원격 저장소에 푸시
$ git push [원격지] --force

# 모든 로컬 브랜치를 원격 저장소에 푸시
$ git push [원격지] --all
  

9. 변경 사항 되돌리기

작업 중 발생한 실수를 복구하거나, 이전 상태로 되돌리는 명령어입니다.


# 스테이징 영역의 파일을 작업 공간으로 되돌리기 (변경 사항 유지)
$ git checkout -- [파일]

# 특정 커밋의 파일을 스테이징 영역 및 작업 공간으로 되돌리기
$ git checkout [커밋] [파일]

# 스테이징 영역의 모든 파일을 작업 공간으로 되돌리기
$ git checkout -- .

# 스테이징 영역의 파일을 마지막 커밋 상태로 재설정 (작업 공간 변경 사항 유지)
$ git reset [파일]

# 스테이징 영역 및 작업 공간의 변경 사항을 마지막 커밋 상태로 되돌리기
$ git reset --hard

# 현재 브랜치의 포인터를 특정 커밋으로 이동 (스테이징 영역만 초기화, 작업 공간 변경 사항 유지)
$ git reset [커밋]

# 현재 브랜치의 HEAD, 스테이징 영역, 작업 공간을 특정 커밋 상태로 동일하게 재설정
$ git reset --hard [커밋]

# 현재 HEAD를 특정 커밋으로 이동하되, 스테이징 영역 및 작업 공간 변경 사항 유지
$ git reset --keep [커밋]

# 특정 커밋을 취소하는 새 커밋 생성 (원래 커밋의 변경 사항을 상쇄)
$ git revert [커밋]

# 커밋되지 않은 변경 사항을 임시 저장하고 작업 공간을 깨끗하게 만들기
$ git stash
# 임시 저장된 변경 사항을 복원
$ git stash pop
  

10. 기타 유용한 명령어

아카이빙 등 추가적인 기능을 제공하는 명령어입니다.


# 릴리스 가능한 아카이브 파일 생성
$ git archive
  

태그: Git 명령어 버전관리 개발

11월 6일 10:23에 게시됨