강의 목표: 수작업 1시간 분량을 1초 만에 끝내는 파일 관리 자동화
현대 비즈니스 환경에서 데이터 관리의 핵심은 효율성입니다. 수백 개의 이미지 파일, 보고서, 로그 파일의 이름을 하나하나 수동으로 변경하는 것은 단순 반복 업무를 넘어 심각한 인적 오류(Human Error)를 야기할 수 있습니다. 오늘 강의에서는 파이썬(Python)의 강력한 내장 라이브러리를 활용하여, 복잡한 규칙을 가진 수백 개의 파일 이름을 단 1초 만에 일괄 변경하는 자동화 스크립트를 제작합니다. 이 과정을 통해 여러분은 파일 시스템 제어의 핵심 원리를 이해하고 실무에 즉시 적용 가능한 기술을 습득하게 될 것입니다.
사전 준비 사항
본 실습을 원활하게 진행하기 위해 다음과 같은 개발 환경 구축이 필요합니다. 2026년 기준 최신 안정화 버전을 바탕으로 구성되었습니다.
- 운영체제(OS): Windows 11, macOS Sequoia, 또는 Linux(Ubuntu 24.04 이상)
- 파이썬 버전: Python 3.12.x 이상 권장
- 개발 도구(IDE): Visual Studio Code (VS Code) 최신 버전
- 필수 설치 라이브러리: 파이썬 표준 라이브러리인
os와pathlib를 사용하므로 별도의 외부 설치는 필요하지 않으나, 진행 상황을 시각적으로 확인하기 위해tqdm라이브러리 설치를 권장합니다.
# 터미널(Terminal) 또는 명령 프롬프트에서 아래 명령어를 입력하세요.
pip install tqdm1단계: 작업 환경 구성 및 대상 폴더 설정
가장 먼저 자동화 작업을 수행할 대상 폴더를 준비해야 합니다. 실습을 위해 바탕화면에 'test_files'라는 폴더를 생성하고, 그 안에 임의의 파일(예: image_01.jpg, image_02.jpg 등) 수백 개를 준비해 주세요. 파이썬 스크립트가 이 폴더의 경로를 정확히 인식하는 것이 모든 자동화의 시작입니다.
절대 경로와 상대 경로 이해하기
스크립트에서 파일을 다룰 때는 ‘절대 경로’를 사용하는 것이 안전합니다. VS Code에서 폴더를 우클릭하여 ‘경로 복사’ 기능을 활용하면 편리합니다. 아래는 기본 경로 설정을 위한 코드 구조입니다.
import os
from pathlib import Path
# 변경할 파일들이 들어있는 폴더 경로 (자신의 환경에 맞게 수정)
target_directory = r'C:\Users\YourName\Desktop\test_files'2단계: 파이썬 핵심 코드 작성
이제 본격적으로 파일 이름을 변경하는 로직을 작성해 보겠습니다. 우리는 파이썬의 os.listdir() 함수로 파일 목록을 가져오고, os.rename() 함수로 이름을 바꿀 것입니다.
파일 목록 추출 및 필터링
폴더 내의 모든 파일을 가져오되, 특정 확장자만 골라내거나 시스템 숨김 파일을 제외하는 필터링 과정이 필요합니다.
import os
from tqdm import tqdm
def batch_rename(folder_path, prefix):
# 1. 폴더 내 파일 목록 가져오기
files = [f for f in os.listdir(folder_path) if os.path.isfile(os.path.join(folder_path, f))]
print(f"총 {len(files)}개의 파일을 발견했습니다.")
# 2. 반복문을 통한 이름 변경
for index, filename in enumerate(tqdm(files, desc="이름 변경 중")):
# 확장자 분리
file_extension = os.path.splitext(filename)[1]
# 새로운 파일 이름 정의 (예: prefix_001.jpg)
new_name = f"{prefix}_{str(index + 1).zfill(3)}{file_extension}"
# 전체 경로 생성
old_path = os.path.join(folder_path, filename)
new_path = os.path.join(folder_path, new_name)
# 실제 이름 변경 실행
os.rename(old_path, new_path)
# 실행부
if __name__ == "__main__":
folder = r'C:\Users\YourName\Desktop\test_files'
batch_rename(folder, "2026_프로젝트_데이터")3단계: 실무형 응용 – 날짜 및 시간 정보 삽입
실무에서는 파일 이름에 단순히 일련번호를 붙이는 것보다, 파일이 생성된 날짜나 특정 키워드를 삽입하는 경우가 많습니다. pathlib 모듈을 사용하면 더 직관적으로 파일의 메타데이터에 접근할 수 있습니다.
파일 생성 날짜 추출하여 이름에 붙이기
from pathlib import Path
from datetime import datetime
def advanced_rename(folder_path):
path = Path(folder_path)
for file_path in path.iterdir():
if file_path.is_file():
# 생성 시간 가져오기
ctime = datetime.fromtimestamp(file_path.stat().st_ctime)
date_str = ctime.strftime('%Y%m%d')
# 새 이름 구성: [날짜]기존이름.확장자
new_filename = f"[{date_str}]_{file_path.name}"
file_path.rename(path / new_filename)
print("고급 이름 변경 완료!")
4단계: 예외 처리와 안전한 실행
수백 개의 파일을 다룰 때는 예기치 못한 오류가 발생할 수 있습니다. 예를 들어, 이미 동일한 이름의 파일이 존재하거나, 파일이 다른 프로그램에 의해 사용 중일 경우 스크립트가 중단될 수 있습니다. 이를 방지하기 위해 try-except 구문을 반드시 사용해야 합니다.
try:
os.rename(old_path, new_path)
except FileExistsError:
print(f"오류: {new_path}가 이미 존재합니다. 건너뜁니다.")
except PermissionError:
print(f"오류: {old_path}가 사용 중입니다. 권한을 확인하세요.")
except Exception as e:
print(f"예상치 못한 오류 발생: {e}")결과 확인 및 마무리
모든 코드를 작성하고 실행했다면, 지정한 폴더로 이동하여 파일들이 규칙에 맞게 정렬되었는지 확인하십시오. 1,000개의 파일이라도 파이썬 스크립트는 단 몇 초 내에 작업을 완료합니다. 오늘 배운 os와 pathlib 라이브러리는 파일 관리 자동화의 기초 중의 기초입니다.
이 스크립트를 응용하면 특정 단어가 포함된 파일만 삭제하거나, 확장자별로 폴더를 자동 분류하는 등 무궁무진한 자동화가 가능합니다. 이제 더 이상 단순 반복적인 파일 이름 바꾸기에 소중한 시간을 낭비하지 마세요. 파이썬 자동화 기술이 여러분의 업무 생산성을 극대화해 줄 것입니다.