[Git] 과거를 추적하는 법: git log로 커밋 기록 조회하고 검색하기

Git을 사용하면서 코드를 수정하고 Commit을 남기는 것만큼 중요한 것이 바로 내가 무엇을 했는지 확인하는 것입니다.

오늘은 프로젝트의 타임머신 기록장이라 할 수 있는 git log 명령어의 다양한 활용법을 알아보겠습니다.

 

1. git log란 무엇인가요?

git log는 현재 브랜치의 Commit 히스토리를 시간 순으로 보여주는 명령어입니다.

터미널에 git log를 입력하면 아래와 같은 실제 결과를 볼 수 있습니다.

 

실제 출력 결과:

commit a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0 (HEAD -> main, origin/main)
Author: YourName <helper@example.com>
Date:   Mon Dec 22 10:00:00 2025 +0900

    feat: 로그인 유효성 검사 로직 추가

commit z9y8x7w6v5u4t3s2r1q0p9o8n7m6l5k4j3i2h1g0
Author: YourName <helper@example.com>
Date:   Sun Dec 21 15:30:00 2025 +0900

    docs: README.md 수정

• commit: 커밋의 고유 아이디(해시값)입니다.
• Author: 누가 작성했는지 보여줍니다.
• Date: 작업한 날짜와 시간입니다.
• 메시지: 작업 내용을 요약한 설명입니다.

 

2. 상황별 git log 활용법 (꿀팁 명령어)

단순히 git log만 치면 내용이 너무 길어 보기 힘들 때가 많습니다. 이때 유용한 옵션들을 소개합니다.

① 한 줄로 깔끔하게 보기 (--oneline)

가장 많이 쓰이는 옵션입니다. 커밋 해시 앞부분과 제목만 한 줄로 보여줍니다.

git log --oneline

실제 출력 결과:

a1b2c3d (HEAD -> main) feat: 로그인 유효성 검사 로직 추가
z9y8x7w docs: README.md 수정
b5v4c3x init: 프로젝트 시작

② 그래프로 흐름 확인하기 (--graph)

브랜치가 갈라지고 합쳐지는 모습을 시각적으로 보여줍니다.

git log --oneline --graph

실제 출력 결과:

* a1b2c3d (HEAD -> main) Merge branch 'feature-login'
|\  
| * z9y8x7w (feature-login) feat: 소셜 로그인 추가
| * b5v4c3x feat: 일반 로그인 구현
* | c8v7b6n docs: 라이선스 추가
|/  
* a1s2d3f init: 프로젝트 시작

 

 

3. 내가 원하는 기록만 쏙쏙 찾기 (검색 기능)

프로젝트 규모가 커지면 수천 개의 커밋 중 특정 기록을 찾는 것이 중요해집니다.

 

• 특정 키워드로 찾기: (메시지에 'fix'가 포함된 것만)

git log --grep="fix"

 

• 특정 파일의 기록만 보기: (README.md 파일이 언제 수정됐는지)

git log README.md

 

 

 

4. git log 화면에서 나가는 법 (중요!)

git log를 치면 화면 아래에 : 표시가 뜨면서 멈춘 것처럼 보일 수 있습니다. 당황하지 마세요!

• 스크롤: 키보드 방향키 또는 Enter
• 나가기: q (Quit의 약자입니다. 키보드의 q만 누르면 바로 터미널로 돌아옵니다.)

 

📝 요약

1. git log: 전체 커밋 히스토리를 확인한다.
2. --oneline --graph: 복잡한 브랜치 흐름을 한 줄로, 그래프로 파악한다.
3. q: 로그 화면에서 빠져나올 때 사용하는 마법의 키.

 

git log로 과거를 확인했다면, 이제 잘못된 커밋을 되돌리는 법을 배울 차례입니다.

다음 포스팅에서는 git reset과 revert의 차이점을 알아보겠습니다!