바쁜 분은 이것만
- 두 파일 비교는
diff -u 옛파일 새파일.-는 빠진 줄,+는 생긴 줄 - 폴더 통째로는
diff -r 폴더1 폴더2, 다른 파일 이름만 보려면diff -rq - 띄어쓰기 차이는 무시하려면
-w. 같은지 다른지만 보려면-q, 종료 코드는 같으면 0, 다르면 1
설정 파일을 고쳤는데 어디를 바꿨는지 기억이 안 나거나, 백업 폴더와 지금 폴더가 뭐가 다른지 알고 싶을 때 맥 터미널의 diff가 제일 빠릅니다. 따로 설치할 것 없이 맥에 기본으로 들어 있어요. 두 파일, 두 폴더 비교와 공백 무시, 한글 파일 이름에서 생기는 함정까지 정리했습니다. 예제는 모두 임시 폴더에 새로 만든 파일로 돌린 출력이에요.
1. diff 기본: 두 파일 비교
설정 파일 두 개를 준비했습니다. b.txt는 포트를 바꾸고 마지막에 한 줄을 더한 버전이에요.
$ cat a.txt
name = baekjo
port = 8000
debug = false
log = info
$ cat b.txt
name = baekjo
port = 8001
debug = false
log = info
timeout = 30
$ diff a.txt b.txt
2c2
< port = 8000
---
> port = 8001
4a5
> timeout = 30
처음 보면 암호 같지만 규칙은 간단해요.
2c2: 첫 파일 2번 줄을 둘째 파일 2번 줄로 바꿈(change)4a5: 첫 파일 4번 줄 뒤에 둘째 파일 5번 줄이 더해짐(add)d가 나오면 지워짐(delete)<는 첫 파일(왼쪽) 내용,>는 둘째 파일(오른쪽) 내용
diff는 다른 곳이 있으면 종료 코드 1, 완전히 같으면 아무것도 출력하지 않고 0, 파일이 없는 등 문제가 생기면 2를 돌려줘요. 스크립트에서 "바뀌었으면 무언가 하기"를 만들 때 이 값을 씁니다.
$ diff a.txt b.txt
...(위와 같음)...
$ echo $?
1
$ diff a.txt a_copy.txt
$ echo $?
0
$ diff nofile.txt a.txt
diff: nofile.txt: No such file or directory
$ echo $?
2
2. diff -u: 깃(git)처럼 보기 편한 형식
실제로는 -u(unified, 통합 형식)를 제일 많이 씁니다. 바뀐 줄 앞뒤 맥락이 같이 나오고, 깃 diff나 깃허브 화면과 같은 모양이라 눈에 익어요.
$ diff -u a.txt b.txt
--- a.txt 2026-11-15 23:10:43
+++ b.txt 2026-11-15 23:10:43
@@ -1,4 +1,5 @@
name = baekjo
-port = 8000
+port = 8001
debug = false
log = info
+timeout = 30
---는 옛 파일,+++는 새 파일 (뒤는 수정 시각)@@ -1,4 +1,5 @@: 옛 파일 1번 줄부터 4줄, 새 파일 1번 줄부터 5줄 구간이라는 뜻- 앞이
-면 빠진 줄,+면 생긴 줄, 공백이면 그대로인 줄
그래서 순서가 중요해요. 옛 파일을 앞, 새 파일을 뒤에 두어야 +가 "새로 생긴 것"으로 읽힙니다. 이 출력을 파일로 남기면 다른 사람에게 바뀐 부분만 보낼 수 있어요.
$ diff -u a.txt b.txt > change.patch
$ cat change.patch | head -3
--- a.txt 2026-11-15 23:10:43
+++ b.txt 2026-11-15 23:10:43
@@ -1,4 +1,5 @@
양쪽을 나란히 보고 싶으면 -y(side by side)도 있습니다. -W는 전체 폭이에요. |는 다른 줄, >는 오른쪽에만 있는 줄입니다.
$ diff -y -W 40 a.txt b.txt
name = baekjo name = baekjo
port = 8000 | port = 8001
debug = false debug = false
log = info log = info
> timeout = 30
3. 같은지만 알고 싶을 때: -q, -s
내용은 필요 없고 같은지 다른지만 궁금하면 -q(quiet)를 씁니다. -s를 붙이면 같을 때도 "같다"고 말해 줘요.
$ diff -q a.txt b.txt
Files a.txt and b.txt differ
$ diff -s a.txt a_copy.txt
Files a.txt and a_copy.txt are identical
4. 띄어쓰기 차이 무시: -b, -w
한글 메모 두 개를 비교해 봤습니다. 오늘 파일은 "우유 사기"에 공백이 두 칸, "메일 답장 " 끝에 공백 한 칸, "책반납"은 공백이 없고, 마지막에 한 줄을 더했어요. 그냥 비교하면 눈으로는 같아 보이는 줄까지 다 다르다고 나옵니다.
$ diff 할일_어제.txt 할일_오늘.txt
1,3c1,4
< 우유 사기
< 메일 답장
< 책 반납
---
> 우유 사기
> 메일 답장
> 책반납
> 운동 30분
$ diff -b 할일_어제.txt 할일_오늘.txt
3c3,4
< 책 반납
---
> 책반납
> 운동 30분
$ diff -w 할일_어제.txt 할일_오늘.txt
3a4
> 운동 30분
-b: 공백 개수 차이와 줄 끝 공백은 무시. 공백이 아예 있고 없고(책 반납 / 책반납)는 다르다고 봐요-w: 공백을 전부 무시. 진짜로 더해진 "운동 30분"만 남았습니다
한글 파일 이름도 그대로 쓰면 됩니다. 다만 이름에 띄어쓰기가 있으면 diff "할 일.txt" "할 일2.txt"처럼 따옴표로 감싸 주세요.
5. 순서가 다른 목록은 정렬해서 비교
diff는 줄 순서대로 비교해서, 순서만 섞인 목록도 다르다고 나와요.
$ diff 명단_1월.txt 명단_2월.txt
1,2d0
< 김철수
< 이영희
3a2,3
> 김철수
> 최지우
김철수는 양쪽에 다 있는데 빠졌다가 다시 생긴 것처럼 보이죠. 이럴 땐 <( )로 정렬한 출력을 바로 넘깁니다. zsh와 bash에서 쓰는 문법으로, 괄호 안 명령의 출력을 파일처럼 다루게 해 줘요.
$ diff <(sort 명단_1월.txt) <(sort 명단_2월.txt)
3c3
< 이영희
---
> 최지우
1월에만 이영희, 2월에만 최지우가 있다는 게 바로 보입니다.
6. 폴더 비교: diff -r, -rq, -x
백업 폴더 v1과 지금 폴더 v2를 비교해 볼게요. 파일 개수부터 세 보면 둘 다 3개입니다. (개수 세는 법은 맥 터미널로 폴더 안 파일 개수 세기 (find | wc -l) 참고)
$ find v1 -type f | wc -l
3
$ find v2 -type f | wc -l
3
개수는 같지만 내용까지 같은지는 모르죠. -r을 붙이면 하위 폴더까지 들어가며 비교합니다.
$ diff -r v1 v2
Only in v1: old_note.txt
diff -r v1/src/main.py v2/src/main.py
1c1
< print("hello")
---
> print("hello, world")
Only in v2: 새파일.txt
Only in v1:왼쪽 폴더에만 있는 파일Only in v2:오른쪽 폴더에만 있는 파일- 양쪽에 있는데 내용이 다르면 그 아래에 차이가 나옵니다. 같은 파일(README.md)은 아예 안 나와요
파일이 많으면 내용까지 다 나오는 게 부담스러우니 -rq로 이름만 봅니다. 특정 파일은 -x 패턴으로 빼요. 패턴은 따옴표로 감싸야 zsh가 먼저 풀어 버리지 않습니다.
$ diff -rq v1 v2
Only in v1: old_note.txt
Files v1/src/main.py and v2/src/main.py differ
Only in v2: 새파일.txt
$ diff -rq -x '*.txt' v1 v2
Files v1/src/main.py and v2/src/main.py differ
바뀐 파일만 자세히 보려면 -ru로 통합 형식을 섞으면 됩니다.
$ diff -ru v1/src v2/src
diff -ru v1/src/main.py v2/src/main.py
--- v1/src/main.py 2026-11-15 23:10:43
+++ v2/src/main.py 2026-11-15 23:10:43
@@ -1 +1 @@
-print("hello")
+print("hello, world")
7. 한글 파일 이름이 똑같은데 Only in이 나올 때
맥에서 한글 파일 이름이 들어간 폴더를 비교하다 보면 이런 이상한 출력을 만날 수 있어요. ls로 보면 이름이 똑같은데 양쪽에 "Only in"이 나옵니다.
$ ls n1 n2
n1:
메모.txt
n2:
메모.txt
$ diff -r n1 n2
Only in n2: 메모.txt
Only in n1: 메모.txt
눈에는 같아도 글자를 저장한 방식이 달라서 그래요. xxd로 이름의 바이트를 찍어 보면 바로 드러납니다.
$ ls n1 | xxd
00000000: eba9 94eb aaa8 2e74 7874 0a .......txt.
$ ls n2 | xxd
00000000: e184 86e1 85a6 e184 86e1 85a9 2e74 7874 .............txt
00000010: 0a .
n1은 "메", "모"를 완성된 글자 하나씩으로 저장한 NFC 방식이고, n2는 ㅁ+ㅔ, ㅁ+ㅗ처럼 자모를 나눠 저장한 NFD 방식이에요. 맥 Finder는 둘을 같은 이름으로 보여 주지만, diff는 이름을 바이트 그대로 맞춰 보기 때문에 다른 파일로 판단합니다. 다른 컴퓨터에서 받은 압축 파일이나 클라우드 동기화 폴더에서 이런 차이가 섞여 들어올 수 있어요.
이름을 NFC로 맞춰 주면 같은 파일로 비교됩니다. 아래는 테스트 폴더 n2 안 파일 이름만 바꾸는 한 줄이에요(실제 폴더에 쓸 때는 백업부터 해 두세요).
$ python3 -c "import os,unicodedata as u; [os.rename('n2/'+f, 'n2/'+u.normalize('NFC', f)) for f in os.listdir('n2')]"
$ diff -r n1 n2
$ echo $?
0
정리
| 하고 싶은 것 | 명령 |
|---|---|
| 두 파일 비교 | diff -u 옛파일 새파일 |
| 나란히 보기 | diff -y 파일1 파일2 |
| 같은지만 확인 | diff -q, 같을 때도 알림 -s, 종료 코드 0/1/2 |
| 공백 무시 | 개수만 -b, 전부 -w |
| 순서 무시하고 목록 비교 | diff <(sort 파일1) <(sort 파일2) |
| 폴더 비교 | diff -r, 이름만 -rq, 빼기 -x '*.txt' |
| 바뀐 부분 파일로 저장 | diff -u a b > change.patch |
| 한글 이름 Only in | ls | xxd로 NFC/NFD 확인 후 이름 맞추기 |
참고: macOS man page — diff(1)(-u, -q, -s, -y, -b, -w, -r, -x), xxd(1) / zsh 공식 설명서 zshexpn "Process Substitution" / Python 공식 문서 — unicodedata.normalize
