Git 치트 시트 — 작업별 명령어 모음

git config set --global user.name "Ana Lee"
git config set --global user.email "ana@example.com"

기존 방식: git config --global user.name "Ana Lee"

모든 커밋에 기록됩니다. Git 호스팅 서비스에 등록된 이메일을 써야 커밋이 계정과 연결됩니다.

git config set --global init.defaultBranch main

기존 방식: git config --global init.defaultBranch main

설정하지 않으면 git init은 여전히 첫 브랜치 이름을 master로 지정합니다(힌트도 출력함).

git config set --global core.editor "code --wait"

기존 방식: git config --global core.editor "code --wait"

파일을 닫을 때까지 대기하는 명령이라면 무엇이든 됩니다: "nano", "vim", "subl -n -w".

git config set --global core.autocrlf true  # Windows
git config set --global core.autocrlf input  # macOS, Linux

기존 방식: git config --global core.autocrlf true

LF로 커밋하고 Windows에서는 CRLF로 체크아웃합니다. 팀 전체라면 사람마다 설정하는 것보다 "* text=auto"가 들어간 .gitattributes 파일이 더 확실합니다.

git --version

git switch와 git restore는 2.23 이상, git config 하위 명령은 2.46 이상이 필요합니다.

git init
git init -b main  # name the first branch

.git 디렉터리를 만듭니다. 빌드 결과물과 비밀 정보가 들어가지 않도록 첫 커밋 전에 .gitignore를 추가하세요.

git clone https://github.com/owner/repo.git
git clone git@github.com:owner/repo.git my-folder

전체 히스토리를 내려받고 원격 "origin"을 설정합니다. 두 번째 형식은 SSH와 사용자 지정 폴더 이름을 사용합니다.

git clone --depth 1 https://github.com/owner/repo.git

히스토리를 건너뛰므로 CI와 대형 저장소에 적합합니다. 나중에 git fetch --unshallow로 나머지를 받을 수 있습니다.

git remote add origin git@github.com:owner/repo.git
git push -u origin main

먼저 호스팅 서비스에 빈 저장소를 만드세요(또는 아래의 gh repo create 사용). -u는 origin/main을 업스트림으로 기억합니다.

git status
git status -s  # short form

스테이징된 파일, 스테이징되지 않은 파일, 추적되지 않는 파일을 나열하고 다음 명령을 제안합니다.

git add file.txt
git add .  # everything in this folder and below

git add -A는 저장소 전체의 삭제도 스테이징합니다.

git add -p file.txt

변경 단위("hunk")를 하나씩 확인합니다. y는 스테이징, n은 건너뛰기, s는 분할, e는 편집입니다.

git commit -m "Add login form"
git commit -am "Fix typo"  # stage tracked files and commit

-a는 추적 중인 파일의 수정과 삭제만 포함하며 새 파일은 포함하지 않습니다.

git mv old.txt new.txt
git rm file.txt

둘 다 변경 사항을 자동으로 스테이징합니다. Git은 내용으로 이름 변경을 감지하므로 일반 mv 후 git add를 해도 됩니다.

git rm --cached .env
echo ".env" >> .gitignore

다음 커밋부터 저장소에서 제거됩니다. 이전 커밋에는 남아 있으므로, 비밀 정보가 들어 있었다면 해당 비밀 정보를 교체하세요.

git branch
git branch -a  # include remote branches
git branch -vv  # show upstream and ahead/behind

현재 브랜치에는 *가 표시됩니다.

git switch -c feature/login

기존 방식: git checkout -b feature/login

현재 커밋에서 시작합니다. 다른 곳에서 시작하려면 시작 지점을 추가하세요: git switch -c hotfix origin/main.

git switch main
git switch -  # back to the previous branch

기존 방식: git checkout main

origin/feature만 있으면 git switch feature가 로컬 추적 브랜치를 자동으로 만듭니다.

git branch -m new-name  # current branch
git branch -m old-name new-name

로컬에서만 이름이 바뀝니다. 원격에서도 바꾸려면 다음 항목을 참고하세요.

git branch -m old-name new-name
git push -u origin new-name
git push origin --delete old-name

원격 이름 변경 명령은 없습니다. 새 이름을 푸시하고 옛 이름을 삭제하세요. 옛 이름으로 열린 풀 리퀘스트는 닫힐 수 있으며, GitHub 웹 UI의 이름 변경 버튼을 쓰면 대상 브랜치가 자동으로 바뀝니다.

git branch -u origin/main
git push -u origin HEAD  # push current branch and track it

기존 방식: git branch --set-upstream-to=origin/main

인수 없는 git pull과 git push가 사용하는 대상이 업스트림입니다.

git switch --detach a1b2c3d
git switch -c rescue  # keep work made there

기존 방식: git checkout a1b2c3d

detached 상태에서 만든 커밋은 어떤 브랜치에도 속하지 않습니다. 다른 곳으로 전환하기 전에 브랜치를 만들지 않으면 reflog로만 찾을 수 있습니다.

git switch main
git merge feature/login
git merge --no-ff feature/login  # always create a merge commit

가능하면 fast-forward로 병합합니다. --no-ff를 쓰면 히스토리에 브랜치가 남습니다.

git merge --squash feature/login
git commit -m "Add login"

합쳐진 변경 사항을 병합 기록 없이 스테이징합니다. 이후 해당 브랜치는 병합된 것으로 표시되지 않습니다.

git status  # list conflicted files
# edit the files, remove <<<<<<< ======= >>>>>>> markers
git add file.txt
git commit  # or: git rebase --continue

git restore --ours file.txt 또는 --theirs로 한쪽을 통째로 선택할 수 있습니다. 리베이스 중에는 "ours"가 리베이스 대상 브랜치를 가리켜 병합과 반대입니다.

git pull --rebase
git config set --global pull.rebase true  # make it the default

가져온 내용 위에 로컬 커밋을 리베이스합니다.

git cherry-pick a1b2c3d
git cherry-pick -x a1b2c3d  # note the source in the message

같은 변경 사항으로 새 커밋을 만듭니다. 범위 지정: git cherry-pick A..B (A 제외).

git remote -v
git remote set-url origin git@github.com:owner/repo.git

set-url로 복제본의 연결을 HTTPS에서 SSH로(또는 이름이 바뀐 저장소로) 바꿉니다.

git fetch
git fetch --prune  # also drop deleted remote branches

origin/*만 업데이트하며 내 브랜치는 그대로입니다.

git pull

git fetch 후 병합합니다(pull.rebase가 설정되어 있으면 리베이스).

git push
git push -u origin HEAD  # first push of a new branch
git config set --global push.autoSetupRemote true

push.autoSetupRemote(Git 2.37 이상)를 설정하면 새 브랜치에서 git push만 해도 업스트림이 자동으로 설정됩니다.

git remote add upstream https://github.com/original/repo.git
git fetch upstream
git switch main
git merge upstream/main

또는 GitHub CLI로: gh repo sync.

git revert a1b2c3d
git revert HEAD  # the latest commit

이전 커밋을 반대로 적용하는 새 커밋을 추가하므로 다른 사람의 히스토리는 바뀌지 않습니다. 공유 브랜치에서 안전하게 되돌리는 방법입니다.

git revert -m 1 <merge-sha>

-m 1은 첫 번째 부모(보통 main)를 유지합니다. 나중에 브랜치를 다시 병합하려면 먼저 이 revert를 revert해야 합니다.

git restore --staged file.txt
git restore --staged .  # everything

기존 방식: git reset HEAD file.txt

변경 사항은 작업 트리에 남고 스테이징만 취소됩니다.

git restore file.txt  # deletion not committed
git restore --source=a1b2c3d~1 file.txt  # deleted in commit a1b2c3d

기존 방식: git checkout a1b2c3d~1 -- file.txt

git log --diff-filter=D -- file.txt로 파일을 삭제한 커밋을 찾으세요.

git reflog
git branch rescued a1b2c3d

reflog는 HEAD가 거쳐 간 모든 위치를 기록합니다. 실수하기 전의 SHA를 찾아 그 위에 브랜치를 만드세요.

git stash
git stash push -m "half-done login"
git stash -u  # include untracked files

추적 중인 변경 사항을 저장하고 작업 트리를 깨끗하게 만들어 브랜치를 전환할 수 있게 합니다.

git stash pop  # apply and drop
git stash apply stash@{1}  # apply, keep the stash

충돌이 생길 수 있습니다. pop을 쓸 때 적용에 실패하면 stash는 유지됩니다.

git stash list
git stash show -p stash@{0}

최신 항목이 먼저 나오며 stash@{0}이 가장 최근 것입니다.

git stash push -- src/login.ts
git stash push --staged  # only what is staged (2.35+)

경로를 지정한 stash는 나머지를 그대로 둡니다.

git stash branch feature/login stash@{0}

stash한 시점의 커밋에 브랜치를 만들고 stash를 적용한 뒤 삭제하므로 충돌을 피할 수 있습니다.

git log --oneline --graph --all

브랜치 구조와 함께 커밋당 한 줄로 표시합니다. 아주 오래된 Git에서는 --decorate를 추가해야 브랜치 이름이 보입니다.

git log --follow -p -- path/file.txt

--follow는 이름 변경 이후까지 추적하고, -p는 각 변경 내용을 보여 줍니다.

git log -S "functionName" --oneline
git log -G "regex" --oneline

-S는 출현 횟수가 바뀐 커밋을, -G는 변경된 줄이 정규식과 일치하는 커밋을 찾습니다.

git log --author="Ana" --since="2 weeks ago" --oneline

--until, 메시지 검색용 --grep="fix", main에는 없고 feature에만 있는 커밋을 보는 main..feature도 있습니다.

git show a1b2c3d
git show a1b2c3d:path/file.txt

두 번째 형식은 내 작업 복사본을 건드리지 않고 해당 커밋 시점의 파일을 출력합니다.

git diff  # unstaged
git diff --staged  # staged, i.e. what will be committed

--stat은 파일별로 요약하고, --word-diff는 일반 글에 더 적합합니다.

git diff main...feature  # changes on feature since it branched
git diff main feature  # the two tips directly

점 세 개는 병합 기준(merge base)과 비교하며, 풀 리퀘스트에 표시되는 것과 같습니다.

git blame -L 10,20 path/file.txt

-w를 추가하면 공백을 무시하고, -C를 추가하면 다른 파일에서 옮겨 온 줄도 추적합니다.

git bisect start
git bisect bad  # current commit is broken
git bisect good v1.4.0  # this one worked
# test, then mark each step good or bad
git bisect reset

이진 탐색으로 약 log2(n)단계가 걸립니다. git bisect run ./test.sh로 자동화할 수 있습니다.

git grep -n "TODO"

대형 저장소에서 grep보다 빠르고 무시된 파일은 건너뜁니다. 커밋을 지정하면 이전 버전을 검색합니다.

git tag -a v1.2.0 -m "Release 1.2.0"
git tag -a v1.1.1 a1b2c3d -m "Hotfix"  # tag an older commit

주석 태그(-a)는 작성자, 날짜, 메시지를 저장하므로 릴리스에는 이쪽을 권장합니다. git tag v1.2.0만 쓰면 경량 태그가 만들어집니다.

git push origin v1.2.0
git push --follow-tags  # annotated tags reachable from pushed commits

git push는 기본적으로 태그를 보내지 않습니다. git push --tags는 불필요한 로컬 태그까지 모든 태그를 보냅니다.

git tag -l "v1.*"
git describe --tags

describe는 가장 가까운 태그와 그 이후 커밋 수를 출력합니다(예: v1.2.0-3-ga1b2c3d).

git submodule add https://github.com/owner/lib.git vendor/lib
git commit -m "Add lib submodule"

.gitmodules에 URL을 기록하고 다른 저장소의 특정 커밋을 고정합니다.

git clone --recurse-submodules <url>
git submodule update --init --recursive  # already cloned

이 작업을 하지 않으면 서브모듈 폴더가 비어 있습니다.

git submodule update --remote
git commit -am "Bump submodules"

각 서브모듈의 추적 브랜치를 가져옵니다. 상위 저장소에서 새로 고정된 커밋을 커밋하세요.

git worktree add ../repo-hotfix hotfix
git worktree add -b review ../repo-review origin/main

같은 저장소를 공유하는 두 번째 작업 폴더로, stash나 추가 복제가 필요 없습니다.

git worktree list
git worktree remove ../repo-hotfix
git worktree prune  # forget folders deleted by hand

워크트리에 커밋하지 않은 변경 사항이 있으면 remove가 거부됩니다(--force로 무시 가능).

git clean -n -d

git clean -f 전에 항상 실행하세요.

git branch --merged main
git branch -d branch-a branch-b

먼저 목록을 확인하세요. -d는 병합되지 않은 브랜치를 거부하므로 시도해도 안전합니다.

git fetch --prune
git config set --global fetch.prune true

서버에서 삭제된 브랜치의 origin/* 참조를 정리합니다.

git maintenance start
git gc

maintenance start는 백그라운드 prefetch, commit-graph, repack 작업을 예약하고, gc는 지금 바로 객체를 압축하고 도달할 수 없는 객체를 정리합니다.

git config list --show-origin

기존 방식: git config --list --show-origin

시스템, 전역, 저장소 값을 각각 들어 있는 파일과 함께 보여 줍니다.

git config set --global alias.st "status -s"
git config set --global alias.lg "log --oneline --graph --all"

기존 방식: git config --global alias.st "status -s"

그러면 git st와 git lg를 쓸 수 있습니다. 앞에 !를 붙이면 셸 명령을 실행합니다: alias.root "!pwd".

git config set --global pull.rebase true
git config set --global push.autoSetupRemote true
git config set --global rerere.enabled true
git config set --global merge.conflictStyle zdiff3
git config set --global diff.algorithm histogram

기존 방식: git config --global pull.rebase true

pull 시 리베이스, 첫 푸시 때 업스트림 자동 설정(2.37 이상), 충돌 해결 기억, 충돌 시 공통 조상 표시(2.35 이상), 더 명확한 diff.

git config set --global core.excludesFile ~/.gitignore_global

기존 방식: git config --global core.excludesFile ~/.gitignore_global

OS와 편집기가 만드는 파일(.DS_Store, .idea/)용입니다. 프로젝트별 규칙은 저장소의 .gitignore에 두세요.

gh auth login
gh auth setup-git  # let git use gh for HTTPS credentials

브라우저를 열거나 토큰을 입력받으며, github.com과 GitHub Enterprise 모두 지원합니다.

gh repo create my-app --private --source=. --push

저장소를 만들어 origin으로 추가하고 현재 브랜치를 푸시합니다.

gh repo clone owner/repo

포크라면 상위 저장소도 upstream 원격으로 추가합니다.

gh pr create --fill
gh pr create --draft --title "WIP: login" --body "…"

--fill은 커밋 메시지를 제목과 본문으로 사용합니다.

gh pr checkout 123

PR 브랜치(포크 포함)를 가져와 전환합니다.

gh pr list
gh pr view 123 --web
gh pr merge 123 --squash --delete-branch

gh pr status는 나와 관련된 PR을 보여 줍니다.

gh issue create --title "Bug: …" --body "…"
gh issue list --assignee @me

gh issue view 42 --comments로 터미널에서 스레드를 읽을 수 있습니다.

gh run list
gh run watch

gh run view --log-failed는 실패한 단계만 출력합니다.