본문으로 바로 가기
인생은 여울여울

홈 / 글 모아보기

ZIP 파일 내용 미리 보기: 파이썬으로 이름과 크기 확인하기

ZIP을 풀기 전에 안에 어떤 이름이 있는지만 확인하려면, 파이썬의 ZipFile을 읽기 모드로 열고 infolist()를 출력하세요. 아래 실습은 연습용 ZIP을 직접 만든 뒤 파일·폴더 이름과 표시된 크기를 확인합니다. 목록을 보는 코드에는 압축 해제 명령이 없습니다.

2026년 9월 25일 macOS의 Python 3.14.4에서 본문과 같은 코드를 실행해 일반 ZIP, 빈 ZIP, ZIP이 아닌 파일, 파일이 없는 경우를 확인했습니다. Python의 ZipFile.infolist() 문서는 압축 파일의 각 항목 정보를 목록으로 돌려준다고 설명합니다.

sample.zip의 notes 폴더 안에 todo.txt가 있고 readme.txt는 바깥에 있으며, 압축을 풀지 않고 이름과 표시 크기를 읽는 설명도
ZIP 안의 폴더 관계를 보여주는 그림입니다. 모바일에서는 세로 그림이 보이며 누르면 원본 크기로 볼 수 있습니다.

연습용 ZIP 하나를 만드세요

아래 코드를 make_sample_zip.py로 저장하세요. 같은 폴더에서 python3 make_sample_zip.py를 실행하면 sample.zip이 새로 만들어집니다. 이미 같은 이름의 파일이 있다면 덮어쓰므로 빈 연습 폴더에서 실행하세요. Windows에서 python3가 없으면 설치된 Python의 py 또는 python 명령을 사용합니다.

from zipfile import ZipFile

with ZipFile("sample.zip", "w") as archive:
    archive.writestr("notes/", "")
    archive.writestr("notes/todo.txt", "할 일")
    archive.writestr("readme.txt", "안내")

이 코드는 연습용 ZIP을 만드는 단계입니다. 다음 목록 확인 코드는 ZIP을 읽기만 합니다. 두 코드를 혼동해 실제 파일 이름으로 제작 코드를 실행하지 마세요.

압축을 풀지 않고 이름과 표시 크기를 보세요

다음 코드를 같은 폴더에 inspect_zip.py로 저장하고 python3 inspect_zip.py를 실행하세요. 첫 코드에서 만든 sample.zip과 같은 폴더에서 실행해야 합니다.

from pathlib import Path
from zipfile import BadZipFile, ZipFile

archive_path = Path("sample.zip")
if not archive_path.is_file():
    print("sample.zip 파일을 찾지 못했습니다.")
else:
    try:
        with ZipFile(archive_path, "r") as archive:
            entries = archive.infolist()
            if not entries:
                print("압축 안에 항목이 없습니다.")
            for entry in entries:
                kind = "폴더" if entry.is_dir() else "파일"
                print(f"{kind}: {entry.filename} ({entry.file_size}바이트)")
    except BadZipFile:
        print("ZIP 형식으로 읽을 수 없습니다.")

"r"은 기존 ZIP을 읽는 모드입니다. infolist()의 각 항목에는 이름과 file_size가 있으며, is_dir()로 폴더 항목인지 구분할 수 있습니다. 이 크기는 ZIP 안에 기록된 압축 전 바이트 수로, 압축 후 파일 크기나 실제로 풀 때 필요한 디스크 공간을 보장하는 수치가 아닙니다. 이름을 나열하는 것만으로 파일 내용이나 신뢰성을 검사한 것도 아닙니다.

실행 결과를 자신의 화면과 비교하세요

연습용 ZIP에서는 다음 세 줄이 나왔습니다. notes/는 폴더 항목이라 0바이트로, 한국어 텍스트는 UTF-8 바이트 수로 표시됩니다.

폴더: notes/ (0바이트)
파일: notes/todo.txt (7바이트)
파일: readme.txt (6바이트)

출력이 다르면 두 스크립트와 sample.zip이 같은 폴더에 있는지 먼저 확인하세요. 앞서 ZIP을 만들지 않았다면 파일을 찾지 못했다는 문장이 나옵니다. 자신의 ZIP을 살펴보려면 원본을 보존한 사본을 연습 폴더에 놓고, archive_path의 파일 이름만 그 사본에 맞춰 바꾸세요. 파일 목록을 다룰 때 경로와 현재 폴더가 헷갈린다면 파이썬으로 샘플 폴더의 파일 목록을 확인하는 실습을 먼저 해보세요.

비어 있거나 ZIP 형식이 아니면 구분하세요

빈 ZIP을 열면 압축 안에 항목이 없습니다.가 나오고, 이름만 .zip으로 바꾼 일반 텍스트 파일을 열면 ZIP 형식으로 읽을 수 없습니다.가 나왔습니다. 확장자를 바꾼다고 파일 내용이 ZIP으로 변하지 않습니다. BadZipFile은 잘못된 ZIP 파일에 쓰는 예외로 공식 문서에 설명돼 있습니다. 암호가 걸렸거나 지원하지 않는 방식의 ZIP 등 모든 실패 원인을 이 짧은 코드가 구별하는 것은 아닙니다.

완료 기준은 연습용 sample.zip에서 위 세 항목의 이름과 0·7·6바이트가 보이는 것입니다. 이 결과가 나오면 자신의 ZIP 사본에서 먼저 파일 이름을 읽어 필요한 항목이 있는지 판단하세요. 이름이나 표시 크기만으로 압축 파일이 안전하다거나 내용이 온전하다고 결론 내리지 마세요.

댓글 남기기