27.Python Pillow로 이미지 처리 마스터하기: VSCode 실전 활용법

저도 처음에는 회사에서 받은 수백 장의 상품 사진 크기를 줄이기 위해, 하나하나 포토샵으로 열어서 마우스 클릭을 반복하고 있었습니다. 정확히 100장쯤 처리했을 때 손가락 마디가 저려오며 '내가 지금 뭘 하고 있는 건가' 싶었던 기억이 납니다. 반나절을 꼬박 의미 없는 클릭질에 쏟아붓고 나서야 검색을 해보니 파이썬으로 이 작업을 자동화할 수 있다는 걸 알게 되었고, 그렇게 만난 라이브러리가 바로 Pillow였습니다. 처음에는 PIL과 Pillow라는 이름이 헷갈려 설치 과정에서 살짝 헤맸지만, 막상 익히고 나니 오전 내내 붙잡고 있던 수백 장의 이미지 리사이징 작업이 단 5초 만에 거짓말처럼 끝났습니다. 이번 글에서는 그때 제가 겪었던 시행착오를 바탕으로, VS Code 환경에서 Pillow를 설치하고 실무 이미지를 다루는 방법을 완벽하게 정리해 보겠습니다


이미지 파일의 크기를 줄이거나, 여러 장의 사진에 똑같은 워터마크를 넣거나, 특정 폴더에 있는 수백 장의 사진을 한 번에 리사이징해야 하는 상황을 겪어본 적이 있으신가요? 이런 반복적인 이미지 작업을 손으로 하나하나 처리하다 보면 시간이 순식간에 사라지는데, Python의 Pillow 라이브러리를 활용하면 이런 작업을 코드 몇 줄로 자동화할 수 있습니다. 이번 글에서는 VSCode 환경에서 Pillow를 설치하고 실제로 이미지를 다루는 방법까지 실전 예제와 함께 정리해보겠습니다.

Pillow란 무엇인가

이미지 처리를 위한 Python 라이브러리

Pillow는 Python에서 이미지를 열고, 편집하고, 저장할 수 있게 해주는 대표적인 이미지 처리 라이브러리입니다. 원래는 PIL(Python Imaging Library)이라는 이름으로 시작했지만, 개발이 중단된 이후 커뮤니티가 이를 이어받아 Pillow라는 이름으로 발전시켜 지금까지 널리 사용되고 있습니다.

비유하자면 Pillow는 마치 포토샵의 기능 중 자주 쓰이는 도구들만 쏙쏙 뽑아서 코드로 자동 실행할 수 있게 만든 미니 편집 도구 상자와 같습니다. 마우스로 클릭하며 작업하는 대신, 코드 한 줄로 수백 장의 이미지에 동일한 작업을 순식간에 적용할 수 있다는 점이 가장 큰 매력입니다.

Pillow로 할 수 있는 작업들

  • 이미지 크기 조절(리사이징) 및 자르기(크롭)
  • 이미지 포맷 변환(JPG, PNG, WEBP 등)
  • 텍스트나 로고 워터마크 삽입
  • 이미지 회전, 반전, 필터 적용
  • 썸네일 자동 생성

VSCode에서 Pillow 개발 환경 준비하기

Pillow 설치하기

VSCode에서 터미널을 열고 다음 명령어로 Pillow를 설치할 수 있습니다.

pip install Pillow

설치가 완료되면 정상적으로 설치되었는지 간단히 확인해보는 것이 좋습니다.

from PIL import Image
print("Pillow 설치 완료!")


인터프리터 설정 확인하기

가상환경을 사용하고 있다면 VSCode 하단의 인터프리터 선택 메뉴에서 올바른 가상환경이 선택되어 있는지 반드시 확인해야 합니다. 인터프리터가 다르게 설정되어 있으면 분명히 설치했는데도 "No module named PIL"이라는 오류를 마주하게 되는데, 이는 마치 냉장고에 분명히 재료를 넣어뒀는데 다른 냉장고 문을 열어서 재료가 없다고 착각하는 것과 비슷한 상황입니다.


Pillow 기본 사용법 실습

이미지 열고 정보 확인하기

가장 먼저 이미지를 불러오고 기본 정보를 확인하는 방법부터 살펴보겠습니다.

from PIL import Image

img = Image.open('sample.jpg')
print(f"이미지 크기: {img.size}")
print(f"이미지 포맷: {img.format}")
print(f"컬러 모드: {img.mode}")

img.show()

이미지 리사이징과 포맷 변환

이미지 크기를 조절하고 다른 포맷으로 저장하는 작업은 다음과 같이 처리합니다.

from PIL import Image

img = Image.open('sample.jpg')

# 크기 조절 (가로 800px 기준)
resized_img = img.resize((800, 600))
resized_img.save('resized_sample.png')

print("리사이징 및 포맷 변환 완료!")

여러 이미지 한 번에 처리하기

Pillow의 진짜 힘은 반복 작업을 자동화할 때 드러납니다. 폴더 안에 있는 이미지 전체를 한 번에 리사이징하는 예제를 살펴보겠습니다.

import os
from PIL import Image

# 현재 파일의 디렉토리를 파이썬 경로에 추가
sys.path.append(os.path.dirname(os.path.abspath(__file__)))

folder_path = './images'

for filename in os.listdir(folder_path):
    if filename.lower().endswith(('.jpg', '.png')):
        img_path = os.path.join(folder_path, filename)
        img = Image.open(img_path)
        img_resized = img.resize((400, 400))
        img_resized.save(f'./resized/{filename}')

print("전체 이미지 리사이징 완료!")

이렇게 반복문과 결합하면 수백 장의 이미지도 순식간에 처리할 수 있어, 마치 세탁소에서 옷을 한 벌씩 다림질하는 대신 대형 프레스로 한 번에 눌러버리는 효율을 얻는 셈입니다.

실전 활용 팁

워터마크 텍스트 삽입하기

이미지에 텍스트를 삽입하고 싶다면 ImageDraw 모듈을 함께 활용하면 됩니다.

from PIL import Image, ImageDraw, ImageFont

img = Image.open('sample.jpg')
draw = ImageDraw.Draw(img)

draw.text((10, 10), "Copyright 2026", fill=(255, 255, 255))
img.save('watermarked_sample.jpg')

썸네일 생성 시 주의할 점

resize() 대신 thumbnail() 메서드를 사용하면 원본 이미지의 비율을 유지하면서 크기를 줄일 수 있어 훨씬 편리합니다. 다만 thumbnail()은 원본 객체 자체를 변경하는 방식이라는 점을 기억해야 하는데, 이를 모르고 사용하면 예상과 다른 결과에 당황할 수 있습니다.

from PIL import Image

img = Image.open('sample.jpg')
img.thumbnail((200, 200))
img.save('thumbnail_sample.jpg')

마무리

지금까지 Python Pillow 라이브러리를 활용해 이미지를 다루는 기본기부터 실전 활용법까지 살펴봤습니다. VSCode 환경에서 직접 코드를 작성하고 실행해보면 이미지 처리라는 작업이 생각보다 훨씬 손쉽게 느껴질 것입니다.

핵심 내용을 정리하면 다음과 같습니다.

  • Pillow는 Python에서 이미지를 다루는 가장 대표적인 라이브러리입니다
  • pip install Pillow 명령어 하나로 간단히 설치할 수 있습니다
  • 리사이징, 포맷 변환, 워터마크 삽입 등 다양한 이미지 편집 작업이 가능합니다
  • 반복문과 결합하면 대량의 이미지를 한 번에 자동으로 처리할 수 있습니다
  • thumbnail() 메서드는 원본 비율을 유지하면서 크기를 줄이는 데 유용합니다

다음 글에서는 Pillow를 활용해 이미지를 자동으로 분류하거나 간단한 필터 효과를 적용하는 방법에 대해 더 깊이 다뤄보도록 하겠습니다.


댓글

댓글 쓰기

이 블로그의 인기 게시물

1.Python 설치부터 실행까지 10분 만에 끝내기 — 초보자도 바로 따라 하는 완벽 가이드

이미지
프로그래밍을 처음 시작하기로 결심한 날, 많은 분들이 유튜브를 켜고 이렇게 검색합니다. "파이썬 설치 방법." 영상을 따라가다 보면 어느 순간 화면 속 강사의 컴퓨터와 내 컴퓨터가 달라지기 시작합니다. "명령어를 찾을 수 없습니다", "PATH가 설정되지 않았습니다" 같은 오류 메시지가 등장하고, 결국 설치도 못 한 채 탭을 닫아버리게 됩니다. 이 글은 바로 그 지점을 해결하기 위해 쓰였습니다. 설치 과정에서 실제로 막히는 이유, 놓치기 쉬운 체크박스 한 칸의 의미, 그리고 첫 코드를 실행하는 순간까지 — 군더더기 없이 안내해 드리겠습니다. 저도 처음 설치때 1시간을 소비 했습니다.이제 해매지 마세요~!!  Python이 실제로 하는 일 — 번역가 비유로 이해하기 Python을 설치하기 전에, Python이 무엇인지 정확히 이해하면 이후 과정이 훨씬 자연스러워집니다. 컴퓨터는 본래 0과 1, 즉 기계어만 이해합니다. 사람이 "파일을 열어줘"라고 말해도 컴퓨터는 알아듣지 못합니다. Python은 바로 이 간극을 메우는 번역가 역할을 합니다. 우리가 사람에게 말하듯 작성한 코드를 컴퓨터가 이해할 수 있는 언어로 변환해 주는 것입니다. 여기서 핵심이 있습니다. 번역가가 없으면 대화가 불가능합니다. Python을 설치한다는 것은 곧 이 번역가를 내 컴퓨터에 고용하는 일입니다. 설치가 완료된 순간부터 여러분의 컴퓨터는 Python이라는 언어를 이해하기 시작합니다. Python을 선택해야 하는 이유 문법이 자연어에 가깝습니다 — if 날씨 == "맑음": 나가기() 처럼, 코드가 한국어 문장 구조와 유사합니다. 범용성이 압도적입니다 — 데이터 분석, 웹 개발, 자동화, AI 모델 구축까지 하나의 언어로 가능합니다. 생태계가 방대합니다 — 전 세계 개발자들이 만든 50만 개 이상의 라이브러리가 무료로 제공됩니다. 취업 시장에서 가장 수요가 높습니다 ...
자세한 내용 보기

30.Python pyautogui로 마우스와 키보드 자동화하기: VSCode 실전 가이드

이미지
 저도 처음에 PATH에서 막혔는데, 매일 반복되는 사내 시스템 클릭 작업을 자동화해보려고 pyautogui 를 설치했지만 VSCode에서 실행할 때마다 "No module named 'pyautogui'"라는 오류만 계속 나왔던 기억이 있습니다. 분명 터미널에서는 설치가 잘 됐다고 나왔는데, 알고 보니 VSCode가 바라보고 있던 Python 인터프리터 경로와 제가 패키지를 설치한 경로가 서로 달랐던 것이 원인이었습니다. 인터프리터를 올바르게 맞춰주고 나서야 마우스가 제 손을 대신해 화면을 클릭하고 키보드를 두드리는 신기한 광경을 볼 수 있었습니다. 이번 글에서는 그때의 시행착오를 바탕으로, VSCode 환경에서 Python pyautogui를 활용해 마우스와 키보드를 자동화하는 방법을 정리해보려 합니다. pyautogui란 무엇인가 마우스와 키보드를 코드로 제어하는 라이브러리 pyautogui 는 Python 코드로 마우스 움직임과 클릭, 키보드 입력을 프로그래밍적으로 제어할 수 있게 해주는 GUI 자동화 라이브러리입니다. 웹 브라우저나 애플리케이션 내부 요소를 직접 다루는 Selenium과 달리, pyautogui는 화면 좌표와 픽셀을 기준으로 동작하기 때문에 특정 프로그램에 국한되지 않고 컴퓨터 화면에서 벌어지는 거의 모든 작업을 자동화할 수 있습니다. 비유하자면 pyautogui는 마치 컴퓨터 앞에 보이지 않는 손 하나를 앉혀두는 것과 같습니다. 이 손은 사람이 시키는 대로 정확한 좌표를 클릭하고, 정해진 문장을 타이핑하며, 화면 속 특정 이미지를 찾아내기까지 하는데, 사람과 다른 점은 지치지 않고 똑같은 작업을 몇 번이고 정확하게 반복한다는 것입니다. pyautogui가 유용한 대표적인 상황 반복적인 클릭 작업이 많은 사내 시스템 업무 자동화 특정 시간마다 실행해야 하는 프로그램 작업 자동화 게임이나 소프트웨어 테스트 시 반복 입력 시뮬레이션 화면 캡처와 이미지 인식을 결합한 자동 작업 흐름 구성 매크로 프로그램을 대...
자세한 내용 보기

29.Python subprocess로 외부 명령어 실행하기: VSCode 실전 활용법

이미지
저도 처음에는 회사에서 매일 반복하던 번거로운 서버 배포 작업을 자동화해 보려고, 파이썬 스크립트 안에 깃( git ) 명령어를 넣어 실행하는 코드를 짰던 것이 시작이었습니다. 분명 내 터미널에 직접 입력할 때는 잘만 되던 명령어가, 파이썬 코드로 실행하니 자꾸 FileNotFoundError 만 뱉어내서 도대체 뭐가 문제인지 몇 시간이나 소스 코드 이 줄 저 줄을 뜯어고치며 밤새 삽질을 했습니다. 알고 보니 코드가 아니라 VS Code가 명령 프로그램의 위치를 찾지 못하는 'PATH 환경변수' 문제였죠. 실행 경로를 명시해 주자마자 스크립트가 배포 작업을 알아서 척척 단 5초 만에 끝내는 걸 보고 , 저는 이 파이썬 자동화의 강력함에 완전히 매료되었습니다. 이번 글에서는 그때의 시행착오를 바탕으로 subprocess 를 활용해 외부 명령어를 안전하게 제어하는 방법을 정리해 보겠습니다. Python 코드 안에서 터미널 명령어를 직접 실행하고 싶었던 적이 있으신가요? 예를 들어 git , ffmpeg , curl 같은 외부 프로그램을 Python 스크립트 안에서 자동으로 호출하고 그 결과를 받아와야 하는 경우가 생각보다 자주 발생합니다. 이럴 때 필요한 것이 바로 subprocess 모듈이며, 이를 활용하면 Python이 마치 터미널을 대신 조작하는 것처럼 외부 프로그램을 자유자재로 실행할 수 있습니다. 이번 글에서는 VSCode 환경에서 Python subprocess를 활용해 외부 명령어를 실행하고 결과를 처리하는 방법을 실전 예제와 함께 정리해보겠습니다. subprocess란 무엇인가 Python에서 외부 프로세스를 실행하는 표준 모듈 subprocess 는 Python 표준 라이브러리에 내장된 모듈로, Python 코드 안에서 운영체제의 명령어나 다른 프로그램을 새로운 프로세스로 실행할 수 있게 해줍니다. 쉽게 말해 여러분이 평소 터미널에 직접 타이핑하던 명령어를, Python 코드가 대신 입력해주고 그 결과까지 받아와주는 것이...
자세한 내용 보기