HOWTO · Batch

배치 스크립트에서 파일 추출 또는 압축 해제

이 튜토리얼에서는 Batch Script에서 파일을 추출하거나 압축 해제하는 방법을 살펴봅니다.

이 페이지의 내용

Windows 배치 파일에서 ZIP 압축 파일을 풀려면 압축 파일과 대상 폴더의 경로를 지정한 다음 명령줄 압축 해제 도구를 호출하면 됩니다. 지원되는 Windows 10 이상 시스템에서는 기본 제공 tar를 사용할 수 있고, 7-Zip을 설치해 대안으로 사용할 수도 있습니다. 이 가이드에서는 명령을 살펴보고 Windows Shell 및 VBScript를 사용하는 방법과 여러 압축 파일을 안전하게 처리하는 방법을 설명합니다. 명령 예제는 Windows 전용 구문이며, 이 패킷에서는 실행하지 않았습니다.

Windows tar로 ZIP 파일 압축 해제하기

지원되는 Windows 10 이상 시스템에서는 별도 도구를 설치하지 않고 tar로 ZIP 압축 파일을 풀 수 있습니다. Microsoft의 Windows tar 명령과 사용 가능 여부에 관한 문서는 여기에서 확인할 수 있습니다. 이 배치 예제에서 zipFile은 C:\Work\sample.zip, outputDir은 C:\Work\sample-extracted입니다. 두 예시 경로를 실제 경로로 바꾸세요. 스크립트는 필요한 경우 대상 폴더를 만든 다음 tar -xf "%zipFile%" -C "%outputDir%"을 실행합니다.

-x 옵션은 압축을 풀고, -f는 압축 파일을 지정하며, -C는 압축을 푼 내용이 저장될 폴더를 지정합니다. 대상 폴더가 없으면 먼저 만듭니다. 변수 값을 따옴표로 감싸면 경로에 공백이 있어도 하나의 인수로 처리됩니다. 이 예제는 ZIP 압축 파일을 대상으로 합니다. 이전 Windows 설치 환경에서도 tar를 사용할 수 있다고 가정하거나, 이 명령이 모든 압축 파일 형식에 적합하다고 가정하지 마세요.

이 내용을 .bat 파일로 저장하고, 지원되는 Windows 환경에서 실행하세요.

@echo off
setlocal
set "zipFile=C:\Work\sample.zip"
set "outputDir=C:\Work\sample-extracted"

if not exist "%zipFile%" (
    echo ZIP archive not found: "%zipFile%"
    exit /b 1
)
if not exist "%outputDir%" (
    mkdir "%outputDir%"
    if errorlevel 1 (
        echo Could not create destination: "%outputDir%"
        exit /b 1
    )
)

tar -xf "%zipFile%" -C "%outputDir%"
exit /b %errorlevel%

Python 표준 라이브러리로 압축 해제 결과를 확인하는 독립 실행형 예제는 다음과 같습니다. 임시 폴더에 작은 ZIP 압축 파일을 만들고, 압축을 푼 뒤, 외부 압축 파일이나 고정 경로에 의존하지 않고 압축 해제된 파일을 확인합니다.

from pathlib import Path
from tempfile import TemporaryDirectory
from zipfile import ZipFile

with TemporaryDirectory() as temp_dir:
    root = Path(temp_dir)
    archive = root / "sample.zip"
    destination = root / "extracted"
    destination.mkdir()

    with ZipFile(archive, "w") as zip_file:
        zip_file.writestr("notes/readme.txt", "Batch extraction demo")

    with ZipFile(archive) as zip_file:
        zip_file.extractall(destination)

    assert (destination / "notes" / "readme.txt").read_text() == "Batch extraction demo"

Python 예제는 원본 압축 파일과 대상 폴더의 관계를 보여 줍니다. 이 예제는 Windows 배치 명령이 아니며, 어떤 Windows 버전에 tar가 포함되는지를 확인해 주지도 않습니다. 위의 Windows tar 명령은 여기서 실행하지 않았습니다. 명령이 성공적으로 실행되면 outputDir에 지정한 폴더 아래에 압축 파일의 내용이 저장됩니다.

7-Zip으로 ZIP 파일 압축 해제하기

7-Zip이 설치되어 있거나 ZIP 이외의 형식도 지원하는 도구가 필요하다면 7-Zip을 사용하세요. 이 배치 예제에서는 sevenZipPath에 C:\Program Files\7-Zip\7z.exe, zipFile에 C:\Work\sample.zip, outputDir에 C:\Work\sample-extracted를 사용합니다. 설치 위치와 파일에 맞게 경로를 바꾸세요. 공식 7-Zip 명령줄 문서에서 명령과 스위치를 확인할 수 있습니다. 스크립트는 필요한 경우 대상 폴더를 만든 다음 "%sevenZipPath%" x "%zipFile%" -o"%outputDir%"을 실행합니다.

x 명령은 압축 파일의 폴더 구조를 유지하면서 압축을 풀고, -o는 대상 폴더를 지정합니다. 예시처럼 -o를 경로에 붙여 쓰세요. 먼저 7-Zip을 설치하거나, 설치 위치에 맞게 sevenZipPath를 바꾸세요. 압축을 푼 파일은 outputDir 아래에 저장됩니다. 이 내용을 .bat 파일로 저장하세요. 이 Windows 명령 예제는 여기서 실행하지 않았습니다. 이후 배치 단계가 압축 해제 완료에 의존한다면 명령의 종료 상태를 확인하고, 성공을 알리기 전에 압축 파일이 일부 파일을 기록했을 가능성도 고려하세요.

@echo off
setlocal
set "sevenZipPath=C:\Program Files\7-Zip\7z.exe"
set "zipFile=C:\Work\sample.zip"
set "outputDir=C:\Work\sample-extracted"

if not exist "%sevenZipPath%" (
    echo 7-Zip executable not found: "%sevenZipPath%"
    exit /b 1
)
if not exist "%zipFile%" (
    echo ZIP archive not found: "%zipFile%"
    exit /b 1
)
if not exist "%outputDir%" (
    mkdir "%outputDir%"
    if errorlevel 1 (
        echo Could not create destination: "%outputDir%"
        exit /b 1
    )
)

"%sevenZipPath%" x "%zipFile%" -o"%outputDir%"
exit /b %errorlevel%

배치 파일에서 Windows Shell과 VBScript 사용하기

Windows 배치 파일에서 Windows Script Host를 호출해 Shell 자동화 개체를 사용할 수 있습니다. Microsoft의 Shell Folder.CopyHere 메서드 문서는 여기에서 확인할 수 있습니다. 다음 .bat 예제는 임시 VBScript 파일 전체를 작성하고, 대상 폴더를 첫 번째 인수로, 원본 ZIP 압축 파일을 두 번째 인수로 전달한 뒤 cscript가 반환되면 임시 파일을 삭제합니다. 예시 경로는 C:\Work\sample.zip과 C:\Work\sample-extracted입니다. 실행하기 전에 실제 경로로 바꾸세요. 스크립트는 Windows Shell이 각 경로를 열 수 있는지 확인하고, 사용할 수 없는 경로를 알립니다.

@echo off
setlocal
set "zipFile=C:\Work\sample.zip"
set "outputDir=C:\Work\sample-extracted"
set "scriptFile=%TEMP%\extract-zip-%RANDOM%.vbs"

if not exist "%zipFile%" (
    echo ZIP archive not found: "%zipFile%"
    exit /b 1
)
if not exist "%outputDir%" (
    mkdir "%outputDir%"
    if errorlevel 1 (
        echo Could not create destination: "%outputDir%"
        exit /b 1
    )
)

> "%scriptFile%" (
    echo Dim shell, destination, source
    echo Set shell = CreateObject^("Shell.Application"^)
    echo Set destination = shell.NameSpace^(WScript.Arguments^(0^)^)
    echo If destination Is Nothing Then
    echo     WScript.Echo "Destination folder is unavailable: " ^& WScript.Arguments^(0^)
    echo     WScript.Quit 2
    echo End If
    echo Set source = shell.NameSpace^(WScript.Arguments^(1^)^)
    echo If source Is Nothing Then
    echo     WScript.Echo "ZIP archive namespace is unavailable: " ^& WScript.Arguments^(1^)
    echo     WScript.Quit 3
    echo End If
    echo destination.CopyHere source.Items
)
if errorlevel 1 (
    echo Could not write temporary VBScript: "%scriptFile%"
    exit /b 1
)

cscript //nologo "%scriptFile%" "%outputDir%" "%zipFile%"
set "scriptStatus=%errorlevel%"
del "%scriptFile%" >nul 2>&1
if not "%scriptStatus%"=="0" (
    echo Windows Script Host returned status %scriptStatus%.
    exit /b %scriptStatus%
)
echo CopyHere was requested; check the destination separately before using extracted files.
exit /b 0

이 방법은 Windows Script Host와 Shell의 ZIP 처리 기능을 사용합니다. 임시 VBScript에서 인수 0은 대상 폴더이고 인수 1은 원본 ZIP 압축 파일입니다. CopyHere는 파일 복사가 끝나기 전에 반환될 수 있으므로 cscript가 성공적으로 반환되어도 압축 해제가 완료됐다고 볼 수 없습니다. 배치 파일의 메시지는 복사 요청이 반환됐다는 사실만 알립니다. 이후 명령에서 압축 해제된 파일을 옮기거나 삭제하거나 읽어야 한다면, 해당 압축 파일과 대상 폴더에 적합한 별도의 완료 확인 절차를 추가하세요. 이 Windows 전용 방법은 실행하지 않은 예제로 제시합니다.

여러 ZIP 파일의 압축 해제 자동화하기

원본 폴더의 ZIP 파일을 반복 처리하고 각 압축 파일에 별도의 대상 폴더를 지정하세요. 대상 폴더를 분리하면 서로 다른 압축 파일에 같은 이름의 파일이 있어도 덮어쓰기를 방지할 수 있습니다. 이 배치 파일은 예시 경로를 설정하고, 원본 폴더가 있는지 확인하며, 출력 루트 폴더를 만들고, 폴더 생성이나 압축 해제 실패를 알립니다. 압축 파일 처리 중 하나라도 실패하거나 ZIP 파일을 찾지 못하면 종료 상태 1을 반환합니다.

@echo off
setlocal
set "sourceDir=C:\Work\incoming"
set "outputRoot=C:\Work\extracted"
set "found=0"
set "failed=0"

if not exist "%sourceDir%\" (
    echo Source directory not found: "%sourceDir%"
    exit /b 1
)
if not exist "%outputRoot%\" (
    mkdir "%outputRoot%"
    if errorlevel 1 (
        echo Could not create output root: "%outputRoot%"
        exit /b 1
    )
)

for %%F in ("%sourceDir%\*.zip") do if exist "%%~fF" call :extract "%%~fF" "%%~nF"

if "%found%"=="0" (
    echo No ZIP files found in: "%sourceDir%"
    exit /b 1
)
if "%failed%"=="1" exit /b 1
echo All ZIP files were extracted successfully.
exit /b 0

:extract
set "found=1"
set "destination=%outputRoot%\%~2"
if not exist "%destination%\" (
    mkdir "%destination%"
    if errorlevel 1 (
        echo Could not create destination for "%~1": "%destination%"
        set "failed=1"
        exit /b 0
    )
)

tar -xf "%~1" -C "%destination%"
if errorlevel 1 (
    echo Extraction failed for: "%~1"
    set "failed=1"
) else (
    echo Extracted "%~1" to "%destination%"
)
exit /b 0

여기서 %%~fF는 현재 압축 파일의 전체 경로로, %%~nF는 .zip 확장자를 뺀 이름으로 확장됩니다. 각 압축 파일은 outputRoot 아래에 이름이 같은 하위 폴더로 압축 해제됩니다. 원본 폴더가 없거나 출력 루트를 만들 수 없으면 스크립트는 즉시 0이 아닌 상태로 종료됩니다. 개별 대상 폴더를 만들지 못하거나 tar 실행에 실패하면 해당 경로를 출력하고 배치 작업을 실패로 표시하지만, 다음 압축 파일 처리는 계속 시도합니다. 이러한 실패가 하나라도 있으면 최종 종료 상태는 0이 아닙니다. 일치하는 ZIP 파일이 없으면 메시지를 출력하고 0이 아닌 상태로 종료합니다. 대화형 Command Prompt에서는 %%F 대신 %F를 사용하세요. 백분율 기호를 두 번 쓰는 방식은 배치 파일에서 사용합니다. tar 명령 예제는 Windows 전용이며 여기서 실행하지 않았습니다.

배치 ZIP 압축 해제 문제 해결하기

  • 명령을 찾을 수 없음: 해당 Windows 설치 환경에서 tar를 사용할 수 있는지 확인하세요. 7-Zip을 사용하는 경우 sevenZipPath가 7z.exe를 가리키고 7-Zip이 설치되어 있는지 확인하세요. 필요한 tar가 없는 이전 Windows 버전에서는 7-Zip 같은 압축 해제 도구를 설치해 사용하세요.
  • 공백이 포함된 경로가 나뉨: 예제처럼 압축 파일과 대상 폴더의 경로를 따옴표로 감싸세요. 7-Zip에서 대상 경로를 따옴표로 감쌀 때는 -o 접두사를 경로 바로 앞에 붙인 상태로 유지하세요. 예: -o"C:\Work Files\Extracted".
  • 대상 폴더를 열거나 만들 수 없음: 상위 폴더가 존재하고 계정에 해당 위치에 쓸 권한이 있는지 확인하세요. 압축을 풀기 전에 대상 폴더를 만들고, 파일 경로가 아니라 폴더를 지정하세요.
  • 파일이 없거나 압축 해제가 완료되지 않은 것처럼 보임: 원본 경로가 올바른 ZIP 압축 파일을 가리키는지, 실제 ZIP 파일인지, 열 수 있는지 확인하세요. 압축 해제 도구의 종료 상태도 확인하세요. Shell/VBScript의 CopyHere 방식을 사용할 때는 압축 해제된 파일을 사용하기 전에 비동기 작업이 끝날 때까지 기다려야 합니다.
  • 여러 압축 파일에 같은 이름의 파일이 들어 있음: 모든 내용을 하나의 대상 폴더에 풀지 말고, 반복 처리 예제처럼 압축 파일마다 별도 폴더에 압축을 푸세요.
  • 다른 셸에서 명령 동작이 다름: 이 배치 구문 예제는 Windows Command Prompt(CMD)를 대상으로 합니다. Bash나 PowerShell 구문이 아니므로 해당 셸에 그대로 붙여 넣어서는 안 됩니다.