🐍 파이썬 초보자 가이즈 : 파일 정리(예제, 자동화)

 안녕하세요, 코딩 초보자 여러분! 👋 여러분의 다운로드 폴더는 혹시 난장판이 되어 있지는 않나요? 수많은 파일들이 뒤섞여 원하는 파일을 찾을 때마다 한숨부터 나오진 않으신가요? 😫

걱정 마세요! 오늘 우리는 **파이썬(Python)**을 사용해서 이 복잡한 폴더를 단 몇 줄의 코드로 깔끔하게 정리해주는 마법 같은 스크립트를 만들어 볼 거예요! 🪄 코딩을 전혀 몰라도 괜찮아요. 예제를 중심으로 아주 쉽게 설명해 드릴게요. 자, 그럼 시작해 볼까요? 🚀

---

📁 파이썬 파일 정리 스크립트 만들기: 첫 걸음!

우리의 목표는 특정 폴더(예: 다운로드 폴더) 안에 있는 파일들을 파일 유형별로 자동으로 분류하여 해당 폴더 안에 생성된 하위 폴더(예: Images, Docs, Videos)로 옮기는 거예요.

1. 필요한 준비물 🔧

이 스크립트를 만들기 위해 딱 두 가지 파이썬 모듈만 있으면 됩니다.

• os: **운영체제(Operating System)**와 상호작용할 수 있게 해주는 모듈입니다. 폴더를 만들거나 파일 목록을 확인하는 등의 작업을 할 때 사용해요.

• shutil: 파일 및 폴더 복사, 이동 등 고급 파일 작업을 쉽게 할 수 있게 해주는 모듈입니다.

💡 참고: 이 두 모듈은 파이썬을 설치하면 기본으로 제공되므로 따로 설치할 필요가 없어요!

2. 기본 코드 구조 잡기 🏗️

먼저, 파일을 정리할 기준 폴더를 정하고, 필요한 모듈을 불러오는 것으로 시작합니다.

Python

import os
import shutil

# 🧹 정리할 대상 폴더 경로 설정 (여러분의 경로로 변경해 주세요!)
TARGET_DIR = "/Users/사용자이름/Downloads" 

3. 파일 분류 기준 정의하기 🏷️

어떤 확장자를 어떤 폴더로 옮길지 미리 정해야겠죠? 우리는 파이썬의 **딕셔너리(Dictionary)**를 사용해서 분류 기준을 정의할 거예요.

Python

# 파일 확장자와 정리될 폴더 이름을 매핑
FILE_TYPES = {
    "Images": ['.jpg', '.jpeg', '.png', '.gif', '.bmp', '.heic'],
    "Docs": ['.pdf', '.docx', '.xlsx', '.pptx', '.txt', '.hwp'],
    "Videos": ['.mp4', '.mov', '.avi', '.mkv', '.wmv'],
    "Archives": ['.zip', '.rar', '.7z', '.tar', '.gz'],
    "Code": ['.py', '.html', '.css', '.js', '.json', '.xml'],
    "Music": ['.mp3', '.wav', '.flac'],
    # 📌 기타 파일은 'Others' 폴더로 이동하게 됩니다.
}

4. 핵심 로직: 파일 이동시키기 ➡️

이제 실제로 파일을 하나씩 확인하고 이동시키는 핵심 코드를 작성할 차례입니다.

A. 폴더 내 모든 파일 확인하기

os.listdir() 함수를 사용하면 해당 경로(TARGET_DIR)에 있는 모든 파일과 폴더 이름을 리스트로 가져올 수 있어요.

Python

# 📂 대상 폴더의 모든 파일/폴더 이름 가져오기
files = os.listdir(TARGET_DIR)

B. 파일 확장자에 따라 분류하고 이동하기

이제 반복문(for 루프)을 사용해서 리스트의 파일들을 하나씩 처리합니다.

Python

for filename in files:
    # 💡 파일의 전체 경로를 만듭니다.
    source_path = os.path.join(TARGET_DIR, filename) 

    # 📁 폴더는 건너뛰고 파일만 처리합니다.
    if os.path.isdir(source_path):
        continue

    # 🏷️ 파일의 확장자를 소문자로 가져옵니다.
    # (예: 'document.PDF' -> '.pdf')
    file_extension = os.path.splitext(filename)[1].lower() 
    
    # 파일을 옮길 폴더 이름 (기본값은 'Others')
    dest_folder_name = "Others" 
    
    # 🔎 FILE_TYPES 딕셔너리를 돌며 해당 확장자를 가진 폴더를 찾습니다.
    for folder, extensions in FILE_TYPES.items():
        if file_extension in extensions:
            dest_folder_name = folder
            break # 찾았으면 반복문을 멈춥니다.
            
    # 🎯 최종 목적지 폴더의 경로를 만듭니다.
    destination_dir = os.path.join(TARGET_DIR, dest_folder_name)
    
    # ⬇️ 목적지 폴더가 없으면 새로 만듭니다. (os.makedirs는 이미 있어도 오류 X)
    os.makedirs(destination_dir, exist_ok=True)
    
    # 🚚 파일 이동 실행!
    destination_path = os.path.join(destination_dir, filename)
    shutil.move(source_path, destination_path)
    print(f"✅ {filename} -> {dest_folder_name} 폴더로 이동 완료!")

---

✨ 최종 파이썬 스크립트 (Full Code)

위의 모든 조각을 합치면 다음과 같은 깔끔한 파일 정리 스크립트가 완성됩니다! 이 코드를 복사하여 file_organizer.py라는 이름으로 저장해 보세요.

Python

import os
import shutil

def organize_files(target_dir):
    # --- 1. 환경 설정 ---
    
    # 파일 확장자와 정리될 폴더 이름을 매핑
    FILE_TYPES = {
        "Images": ['.jpg', '.jpeg', '.png', '.gif', '.bmp', '.heic'],
        "Docs": ['.pdf', '.docx', '.xlsx', '.pptx', '.txt', '.hwp'],
        "Videos": ['.mp4', '.mov', '.avi', '.mkv', '.wmv'],
        "Archives": ['.zip', '.rar', '.7z', '.tar', '.gz'],
        "Code": ['.py', '.html', '.css', '.js', '.json', '.xml'],
        "Music": ['.mp3', '.wav', '.flac'],
    }
    
    # 📂 대상 폴더의 모든 파일/폴더 이름 가져오기
    try:
        files = os.listdir(target_dir)
        print(f"🔍 '{target_dir}' 폴더의 파일 {len(files)}개를 확인합니다.")
    except FileNotFoundError:
        print(f"❌ 오류: 지정된 경로 '{target_dir}'를 찾을 수 없습니다.")
        return

    # --- 2. 파일 처리 로직 ---
    
    moved_count = 0
    
    for filename in files:
        source_path = os.path.join(target_dir, filename) 

        # 1. 폴더는 건너뛰기
        if os.path.isdir(source_path):
            continue

        # 2. 확장자 추출 및 분류
        file_extension = os.path.splitext(filename)[1].lower() 
        dest_folder_name = "Others" # 기본 폴더
        
        for folder, extensions in FILE_TYPES.items():
            if file_extension in extensions:
                dest_folder_name = folder
                break
                
        # 3. 목적지 경로 설정 및 폴더 생성
        destination_dir = os.path.join(target_dir, dest_folder_name)
        os.makedirs(destination_dir, exist_ok=True)
        
        # 4. 파일 이동
        destination_path = os.path.join(destination_dir, filename)
        
        try:
            # 📛 이미 같은 이름의 파일이 목적지에 있다면 이동하지 않습니다.
            if os.path.exists(destination_path):
                 print(f"⚠️ {filename}: 목적지에 같은 파일이 이미 존재하여 건너뜁니다.")
                 continue

            shutil.move(source_path, destination_path)
            moved_count += 1
            # print(f"✅ {filename} -> {dest_folder_name} 폴더로 이동") # 이동 로그는 선택 사항
            
        except Exception as e:
            print(f"❗ {filename} 이동 중 오류 발생: {e}")


    # --- 3. 결과 출력 ---
    print("\n--- 정리 결과 ---")
    print(f"✨ 총 {moved_count}개의 파일이 성공적으로 정리되었습니다! ✨")
    print("이제 폴더가 훨씬 깨끗해졌을 거예요! 👍")


# 📌 스크립트 실행!
# 이곳에 여러분의 실제 다운로드 폴더 경로를 넣어주세요.
DOWNLOADS_PATH = "/Users/사용자이름/Downloads" # <--- 이 부분을 꼭 수정하세요! 
# (예: Windows 사용자: "C:\\Users\\사용자이름\\Downloads")

if __name__ == "__main__":
    organize_files(DOWNLOADS_PATH)

---

💻 스크립트 실행 방법

1. 위의 코드를 복사하여 file_organizer.py라는 이름으로 저장합니다.

2. 스크립트 상단에 있는 DOWNLOADS_PATH 변수의 값을 여러분의 실제 다운로드 폴더 경로로 변경하는 것을 절대 잊지 마세요!

3. 터미널(Terminal) 또는 명령 프롬프트(Command Prompt)를 열고, 스크립트가 저장된 위치로 이동합니다.

4. 다음 명령어를 입력하여 스크립트를 실행합니다.

Bash

python file_organizer.py

잠시 후, 화면에 정리 로그가 표시되고 여러분의 다운로드 폴더는 와 같이 깔끔하게 정리되어 있을 거예요! 😄

🎁 초보자를 위한 추가 팁!

팁 1. 확장자 추가/수정하기

혹시 여러분이 자주 사용하는 파일 유형(예: 디자인 파일인 .psd, .ai)이 있다면, FILE_TYPES 딕셔너리에 새로운 항목을 추가하거나 기존 목록에 확장자를 넣어주기만 하면 됩니다.

Python

# 'Design' 폴더를 새로 추가하고 확장자를 넣습니다.
FILE_TYPES = {
    # ... (기존 목록)
    "Design": ['.psd', '.ai', '.xd'],
    # ...
}

팁 2. 스크립트 자동 실행 설정

매번 수동으로 실행하기 귀찮다면, 윈도우의 작업 스케줄러나 맥/리눅스의 Crontab 기능을 사용해서 매일 저녁 10시처럼 원하는 시간에 이 스크립트가 자동으로 실행되도록 설정할 수 있어요. 한 번 설정해두면 영원히 깔끔한 폴더를 유지할 수 있답니다! 🥳

이제 여러분은 파이썬을 이용해 일상의 작은 불편함을 해결하는 첫 번째 자동화 프로젝트를 성공적으로 완수했습니다! 멋져요! 👍 이 경험을 바탕으로 더 많은 파이썬 자동화에 도전해 보세요!