파이썬 glob 모듈로 확장자별 파일 일괄 검색하는 방법

🔗 glob 모듈이란?

파이썬에서 파일 경로나 이름을 검색할 때 가장 유용하게 활용되는 모듈 중 하나가 바로 glob입니다.
glob는 Unix 스타일의 경로 패턴을 사용하여 원하는 파일 목록을 손쉽게 가져올 수 있게 도와줍니다.
예를 들어 폴더 안에 있는 모든 텍스트 파일, 이미지 파일 등 특정 확장자를 가진 파일만 일괄적으로 불러오고 싶을 때 매우 유용하죠.

특히 와일드카드 문자(*)를 사용할 수 있다는 점에서, os.listdir()과 같은 다른 파일 목록 처리 함수보다 훨씬 간편합니다.
glob는 표준 라이브러리 모듈이기 때문에 별도로 설치할 필요 없이 파이썬을 설치하면 바로 사용할 수 있습니다.

• 📁특정 폴더 내 파일을 리스트로 가져오고 싶을 때
• 🔎특정 확장자(.txt, .csv 등)만 필터링할 때
• 🧹불필요한 파일을 자동으로 삭제하거나 이동할 때

💬 glob는 기본적으로 문자열 매칭 기능만 제공하므로, 정규표현식이나 복잡한 필터링이 필요한 경우에는 re 모듈이나 pathlib과 함께 사용하면 더 강력한 처리가 가능합니다.

🛠️ glob의 기본 사용법과 예제

glob 모듈을 사용하는 방법은 매우 간단합니다.
우선 모듈을 import하고, glob.glob() 함수를 사용하여 경로 패턴을 지정하면 됩니다.
가장 기본적인 예로, 현재 폴더에 있는 모든 텍스트 파일을 불러오는 코드는 다음과 같습니다.

import glob

# 현재 폴더에 있는 모든 .txt 파일 찾기
txt_files = glob.glob("*.txt")

print(txt_files)

위 코드를 실행하면, 현재 작업 디렉토리에 있는 모든 .txt 파일의 이름이 리스트 형태로 출력됩니다.
예를 들어 ‘note1.txt’, ‘sample.txt’ 등 파일명이 포함된 리스트가 반환되는 식이죠.

또한 glob 모듈은 상대 경로뿐만 아니라 절대 경로도 사용할 수 있고, 와일드카드를 활용해 다양한 형태의 파일 패턴을 지정할 수 있습니다.
예를 들어 ‘data_*.csv’라고 입력하면, ‘data_’로 시작하는 모든 CSV 파일을 검색할 수 있어요.

• ⭐“*.txt”는 모든 텍스트 파일을 의미
• 📌“data_*.csv”는 data_로 시작하는 모든 csv 파일
• 🔎“*/logs/*.log”처럼 하위 폴더 패턴도 지정 가능

⚙️ 특정 확장자 파일만 필터링하는 방법

glob 모듈의 가장 강력한 기능 중 하나는 바로 특정 확장자를 가진 파일만 쉽게 필터링할 수 있다는 점입니다.
예를 들어, 수많은 파일 중에서 오직 이미지 파일(.jpg), 텍스트 파일(.txt), 엑셀 파일(.xlsx)만 추출하고 싶을 때 glob 패턴을 이용하면 손쉽게 해결됩니다.

아래 예시는 한 디렉토리 내에서 .csv 파일만 가져오는 코드입니다.

import glob

# .csv 확장자를 가진 모든 파일 찾기
csv_files = glob.glob("*.csv")

print(csv_files)

만약 특정 접두어 또는 접미어가 있는 파일을 찾고 싶다면, 와일드카드(*)와 조합해서 더욱 세밀한 검색이 가능합니다.

• 📄“report_*.xlsx” : ‘report_’로 시작하는 엑셀 파일
• 🖼️“*.png” : 모든 PNG 이미지
• 📝“*_log.txt” : ‘_log’로 끝나는 텍스트 파일

🔌 하위 폴더까지 검색하는 방법

기본적으로 glob.glob() 함수는 지정한 폴더 내에서만 파일을 검색합니다.
하지만 프로젝트 구조가 깊거나, 여러 서브폴더에 파일이 분산되어 있는 경우 하위 디렉토리까지 모두 검색해야 할 때가 있죠.
이럴 때는 재귀 검색 패턴(**)을 활용하면 손쉽게 해결할 수 있습니다.

파이썬 3.5 이상부터는 glob.glob()에 recursive=True 옵션을 사용하면 ‘**’ 패턴을 인식할 수 있습니다.

import glob

# 모든 하위 폴더 포함하여 .py 파일 검색
python_files = glob.glob("**/*.py", recursive=True)

print(python_files)

위 예제는 현재 디렉토리와 그 아래 모든 하위 디렉토리까지 탐색하여, 확장자가 ‘.py’인 파일을 모두 리스트로 반환합니다.
특히 크롤링이나 대용량 데이터 정리 작업을 할 때 매우 유용하게 활용됩니다.

• 📂“**/*.txt” : 하위 폴더 포함 모든 텍스트 파일
• 🔁recursive=True 옵션 꼭 필요
• 🚫재귀 검색 시 성능 저하 주의 (파일 수가 많은 경우)

💡 glob 사용 시 주의할 점

glob 모듈은 매우 직관적이고 편리하지만, 몇 가지 주의할 점도 함께 알아두는 것이 좋습니다.
단순한 패턴 매칭을 기반으로 하기 때문에 예상치 못한 결과가 나오거나, 시스템 리소스를 과도하게 사용하는 상황이 발생할 수 있기 때문입니다.

특히 재귀 검색을 수행할 때는 검색 범위가 넓어지는 만큼 파일 수가 많아지면 성능 저하가 발생할 수 있으며, 파일 경로가 너무 길거나 특수 문자 등이 포함된 경우에는 오류가 날 수도 있습니다.

• ⚠️파일 수가 많을 경우 메모리 과다 사용 가능
• 🔎패턴 누락 시 원하는 파일이 검색되지 않을 수 있음
• 🚫정규표현식은 지원하지 않음 (fnmatch 또는 re 모듈 사용 필요)

이러한 점들을 고려하여 glob을 사용할 때는 항상 패턴을 구체적으로 작성하고, 필요한 경우 다른 모듈과 병행 사용하는 것이 더 안정적이고 효율적인 코드 작성으로 이어질 수 있습니다.

❓ 자주 묻는 질문 (FAQ)