반응형

바쁜 분은 이것만

  1. 폴더 전체에서 글자 찾기는 grep -rn "단어" . (파일 이름:줄 번호:내용)
  2. 대소문자 무시 -i, 파일 이름만 -l, 확장자 지정 --include='*.py' (따옴표 필수)
  3. 한글도 그대로 찾아지지만 윈도우에서 만든 CP949 파일은 안 걸려요. iconv로 바꿔서 찾기

"그 설정 어느 파일에 적어 뒀더라?", "TODO 남긴 데가 어디였지?" 할 때 파일을 하나씩 열어 보는 대신 grep을 씁니다. 파일 안의 글자를 찾아서 어느 파일 몇 번째 줄인지 알려 주는 명령이에요. 맥에 기본으로 들어 있는 grep(BSD grep) 기준으로 자주 쓰는 옵션과 한글 검색, Spotlight 검색인 mdfind와의 차이를 정리했습니다. 예제는 테스트 폴더에 새로 만든 파일 6개로 돌렸어요.

work/
├── notes/회의록_1105.md
├── notes/memo.txt
├── src/app.py
├── src/util.js
├── src/node_modules/lib/index.js
└── old/report.csv   (CP949로 저장한 한글 CSV)

1. grep 기본: 파일 하나에서 찾기

grep 찾을글자 파일 순서입니다. 그 글자가 들어 있는 줄을 통째로 보여 줘요.

$ grep TODO notes/회의록_1105.md
TODO: 테스트 추가

찾을 글자에 띄어쓰기나 특수문자가 있으면 grep "API 키" 파일처럼 따옴표로 감싸 주세요.

2. grep -r: 폴더 전체 뒤지기, -n으로 줄 번호

-r(recursive)을 붙이면 폴더 안 하위 폴더까지 전부 찾습니다. 마지막의 .은 "지금 폴더"라는 뜻이에요.

$ grep -r TODO .
./notes/회의록_1105.md:TODO: 테스트 추가
./src/node_modules/lib/index.js:// TODO vendor
./src/app.py:# TODO: 에러 처리

파일 경로:내용 형식으로 나옵니다. 여기에 -n을 더하면 줄 번호가 들어가서 편집기로 바로 찾아가기 좋아요.

$ grep -rn TODO .
./notes/회의록_1105.md:3:TODO: 테스트 추가
./src/node_modules/lib/index.js:1:// TODO vendor
./src/app.py:2:# TODO: 에러 처리

맥 grep은 -r을 쓰고 폴더를 빼먹으면 지금 폴더를 찾아요. grep -r TODO만 쳐도 위와 같은 세 줄이 나왔습니다. 다만 어디를 찾는지 분명하게 .을 붙이는 습관이 헷갈리지 않아요.

3. -i 대소문자 무시, -l 파일 이름만

위에서는 Todo, todo가 빠졌습니다. grep은 대소문자를 가리기 때문이에요. -i를 붙이면 다 찾습니다.

$ grep -rni todo .
./notes/회의록_1105.md:3:TODO: 테스트 추가
./notes/memo.txt:1:Todo 목록 정리
./src/util.js:1:// todo: 정리
./src/node_modules/lib/index.js:1:// TODO vendor
./src/app.py:2:# TODO: 에러 처리

어떤 줄인지는 필요 없고 어느 파일에 있는지만 알고 싶으면 -l입니다. 파일이 많을 때 목록만 뽑기 좋아요.

$ grep -rli todo .
./notes/회의록_1105.md
./notes/memo.txt
./src/util.js
./src/node_modules/lib/index.js
./src/app.py

파일마다 몇 줄이 걸렸는지 세려면 -c를 씁니다. 없는 파일은 0으로 나와요.

$ grep -rc TODO src
src/util.js:0
src/node_modules/lib/index.js:1
src/app.py:1

4. --include로 확장자 지정, --exclude-dir로 폴더 빼기

파이썬 파일에서만 찾고 싶을 때 --include를 씁니다. 여기서 맥 zsh 사용자가 자주 막히는 곳이 있어요. 따옴표 없이 쓰면 이렇게 됩니다.

$ grep -rn --include=*.py TODO .
zsh: no matches found: --include=*.py

zsh가 grep에 넘기기 전에 *.py를 지금 폴더의 파일 이름으로 바꾸려다 맞는 게 없어서 멈춘 거예요. (이 에러는 zsh: no matches found 에러 정리 글에 자세히 정리해 두었습니다.) 패턴을 따옴표로 감싸면 됩니다. 여러 확장자는 --include를 여러 번 붙여요.

$ grep -rn --include='*.py' TODO .
./src/app.py:2:# TODO: 에러 처리
$ grep -rn --include='*.py' --include='*.js' -i todo .
./src/util.js:1:// todo: 정리
./src/node_modules/lib/index.js:1:// TODO vendor
./src/app.py:2:# TODO: 에러 처리

개발 폴더에서는 node_modules나 .venv처럼 남이 만든 파일이 잔뜩 든 폴더가 검색을 느리게 하고 출력도 지저분하게 만들어요. --exclude-dir로 뺍니다.

$ grep -rni todo --exclude-dir=node_modules .
./notes/회의록_1105.md:3:TODO: 테스트 추가
./notes/memo.txt:1:Todo 목록 정리
./src/util.js:1:// todo: 정리
./src/app.py:2:# TODO: 에러 처리

여러 단어 중 하나라도 들어간 줄은 -E와 |로 찾을 수 있어요.

$ grep -rnE 'TODO|배포' notes
notes/회의록_1105.md:1:다음 배포는 금요일
notes/회의록_1105.md:3:TODO: 테스트 추가

5. 한글 검색과 CP949 파일

한글은 따로 설정 없이 그대로 찾아집니다. 파일 이름이 한글이어도 괜찮아요.

$ grep -rn 배포 .
./notes/회의록_1105.md:1:다음 배포는 금요일

그런데 old/report.csv에 분명히 "김철수"가 있는데 찾으면 아무것도 안 나옵니다.

$ grep -r 김철수 .
$ echo $?
1
$ file old/report.csv
old/report.csv: ISO-8859 text

이 파일은 윈도우 엑셀 등에서 많이 쓰는 CP949(EUC-KR 계열)로 저장돼 있어요. 터미널은 UTF-8로 "김철수"를 찾는데 파일 안의 바이트가 달라서 안 걸리는 겁니다. file 명령이 한글 인코딩을 정확히 짚지 못하고 ISO-8859라고 나오는 것도 이런 파일의 특징이에요. iconv로 UTF-8로 바꿔서 grep에 넘기면 찾아집니다.

$ iconv -f CP949 -t UTF-8 old/report.csv | grep -n 김철수
2:김철수,90

참고로 grep은 찾으면 종료 코드 0, 못 찾으면 1을 돌려줘요. 스크립트에서 if grep -q 단어 파일; then ...처럼 조건으로 쓸 수 있습니다.

6. mdfind와 차이: 언제 뭘 쓸까

맥에는 Spotlight 색인을 쓰는 mdfind도 있어요(사용법은 맥 터미널 mdfind로 파일 빨리 찾기). 같은 폴더에서 돌려 봤습니다. 2>/dev/null은 mdfind가 찍는 안내 로그를 숨기는 용도예요.

$ mdfind -onlyin . 배포 2>/dev/null
~/work/notes/회의록_1105.md
$ mdfind -onlyin . 김철수 2>/dev/null
~/work/old/report.csv
$ mdfind -onlyin . TODO 2>/dev/null
~/work/notes/회의록_1105.md
~/work/notes/memo.txt
~/work/src/app.py
~/work/src/util.js
~/work/src/node_modules/lib/index.js

mdfind는 CP949 파일의 "김철수"도 찾았고, 대소문자도 알아서 무시했어요. 대신 파일 목록만 주고 몇 번째 줄인지는 알려 주지 않습니다. 그리고 단어 단위로 찾아서, 단어 중간 글자로는 안 걸려요.

$ mdfind -onlyin . 포는 2>/dev/null
$ grep -rl 포는 .
./notes/회의록_1105.md
  grep mdfind
찾는 방식 파일을 직접 열어 읽음 미리 만든 Spotlight 색인 조회
출력 파일·줄 번호·줄 내용 파일 경로만
글자 일부로 찾기 됨 (어디든 들어 있으면) 단어 단위
어울리는 곳 코드 폴더, 정확한 위치가 필요할 때 맥 전체에서 문서 빨리 찾을 때

mdfind는 색인된 곳만 찾기 때문에 /tmp 같은 임시 폴더나 색인에서 뺀 폴더, 방금 만든 파일은 안 나올 수 있어요. 코드에서 정확한 줄을 찾을 땐 grep, 어느 문서였는지 대충 기억날 땐 mdfind로 나눠 쓰면 편합니다.

정리

하고 싶은 것 명령
파일 하나에서 찾기 grep 단어 파일
폴더 전체 + 줄 번호 grep -rn 단어 .
대소문자 무시 -i
파일 이름만 / 개수 -l / -c
확장자 지정 --include='*.py' (zsh는 따옴표 필수)
폴더 빼기 --exclude-dir=node_modules
여러 단어 중 하나 grep -E 'A|B'
CP949 한글 파일 iconv -f CP949 -t UTF-8 파일 | grep 단어
맥 전체 문서 검색 mdfind 단어 (파일 목록만)

참고: macOS man page — grep(1)(-r, -n, -i, -l, -c, -E, --include, --exclude-dir), iconv(1), file(1), mdfind(1) / zsh 공식 설명서 zshexpn "Filename Generation"

반응형

+ Recent posts