Code Archaeology and Change Tracking with Git Blame

Beginner7 min

Use git blame and git log to trace the history of code changes, understand why lines were written, and find the context behind decisions.

Prerequisites

-Git installed
-A repository with meaningful commit history

Steps

Blame a file to see line-by-line authorship

Show each line of a file annotated with the commit hash, author, and date of the last change. This tells you who changed each line and when.

$ git blame src/utils/auth.ts

Use 'git blame -w' to ignore whitespace changes, which often clutter blame output after reformatting.

Blame a specific line range

Focus on lines 45 through 65. This is much faster than blaming the entire file when you know which lines you are investigating.

$ git blame -L 45,65 src/utils/auth.ts

See the commit details for a blamed line

Once blame identifies the commit hash, use git show to see the full commit diff, message, and context of why the change was made.

$ git show abc1234

Trace a line through renames and moves

Search for commits that added or removed the string 'validateToken' in the file, even across renames. The -p flag shows the actual diff.

$ git log --follow -p -S 'validateToken' -- src/utils/auth.ts

Use -G instead of -S for regex pattern matching. -S finds commits where the count of the string changes, while -G finds commits where the diff matches the pattern.

Ignore bulk formatting commits in blame

Skip a specific commit (like a code formatting change) in blame output. Git will attribute the lines to the previous meaningful change instead.

$ git blame --ignore-rev abc1234 src/utils/auth.ts

Create a .git-blame-ignore-revs file with commit hashes to always ignore, then configure it with: git config blame.ignoreRevsFile .git-blame-ignore-revs

View file history with full diffs

Show the complete change history of a file with diffs for each commit. The --follow flag tracks the file even if it was renamed.

$ git log -p --follow -- src/utils/auth.ts

Full Script

full-script.sh

#!/usr/bin/env bash
# git-archaeology.sh — Code archaeology helper
set -euo pipefail

FILE="${1:?Usage: $0 <file> [line-start] [line-end] [search-string]}"
LINE_START="${2:-}"
LINE_END="${3:-}"
SEARCH="${4:-}"

echo "=== File: $FILE ==="
echo ""

if [ -n "$SEARCH" ]; then
  echo "--- Commits containing '$SEARCH' ---"
  git log --oneline -S "$SEARCH" --follow -- "$FILE"
  echo ""
  echo "--- Diffs for '$SEARCH' ---"
  git log -p -S "$SEARCH" --follow -- "$FILE" | head -100
elif [ -n "$LINE_START" ] && [ -n "$LINE_END" ]; then
  echo "--- Blame for lines $LINE_START-$LINE_END ---"
  git blame -w -L "$LINE_START,$LINE_END" "$FILE"
  echo ""
  echo "--- Log for lines $LINE_START-$LINE_END ---"
  git log --oneline -L "$LINE_START,$LINE_END:$FILE" | head -40
else
  echo "--- Blame (ignoring whitespace) ---"
  git blame -w "$FILE" | head -50
  echo ""
  if [ "$(git blame "$FILE" | wc -l)" -gt 50 ]; then
    echo "(showing first 50 lines, use line range for specifics)"
  fi
  echo ""
  echo "--- Recent file history ---"
  git log --oneline --follow -10 -- "$FILE"
fi

FAQ

Discussion

Loading comments...

#!/usr/bin/env bash # git-archaeology.sh — Code archaeology helper set -euo pipefail FILE="${1:?Usage: $0 <file> [line-start] [line-end] [search-string]}" LINE_START="${2:-}" LINE_END="${3:-}" SEARCH="${4:-}" echo "=== File: $FILE ===" echo "" if [ -n "$SEARCH" ]; then echo "--- Commits containing '$SEARCH' ---" git log --oneline -S "$SEARCH" --follow -- "$FILE" echo "" echo "--- Diffs for '$SEARCH' ---" git log -p -S "$SEARCH" --follow -- "$FILE" | head -100 elif [ -n "$LINE_START" ] && [ -n "$LINE_END" ]; then echo "--- Blame for lines $LINE_START-$LINE_END ---" git blame -w -L "$LINE_START,$LINE_END" "$FILE" echo "" echo "--- Log for lines $LINE_START-$LINE_END ---" git log --oneline -L "$LINE_START,$LINE_END:$FILE" | head -40 else echo "--- Blame (ignoring whitespace) ---" git blame -w "$FILE" | head -50 echo "" if [ "$(git blame "$FILE" | wc -l)" -gt 50 ]; then echo "(showing first 50 lines, use line range for specifics)" fi echo "" echo "--- Recent file history ---" git log --oneline --follow -10 -- "$FILE" fi