간단한 설명서

파이썬(py) 파일을 EXE 실행 파일로 만드는 방법

파이썬으로 작성한 스크립트를 다른 사람과 공유하거나 설치되지 않은 환경에서도 실행하고 싶을 때, .py 파일을 .exe 실행 파일로 변환하는 방법이 유용합니다. 윈도우 환경에서는 이 과정을 통해 별도의 파이썬 설치 없이 프로그램을 배포할 수 있습니다.

1. pyinstaller 설치

pyinstaller는 파이썬 스크립트를 실행 파일로 만들어주는 가장 널리 사용되는 라이브러리입니다.
먼저, 아래 명령어로 설치합니다:

pip install pyinstaller

설치가 완료되면 명령 프롬프트나 터미널에서 pyinstaller 명령어를 사용할 수 있습니다.

2. 기본 실행파일 생성

다음 명령어를 통해 기본적인 EXE 파일을 생성할 수 있습니다:

pyinstaller your_script.py

이 명령어를 실행하면 다음과 같은 폴더와 파일이 생성됩니다:

• dist/: 실행 파일이 생성되는 폴더
• build/: 임시 빌드 파일
• your_script.spec: 스펙 파일

실행 파일은 dist 폴더 안에 생성됩니다.

3. 단일 실행 파일 만들기

기본 설정은 여러 파일이 함께 생성됩니다. 하지만 단일 EXE 파일을 만들고 싶다면 아래 옵션을 추가합니다:

pyinstaller --onefile your_script.py

이렇게 하면 dist 폴더 안에 하나의 EXE 파일만 생성됩니다.

4. 아이콘 설정

원하는 아이콘이 있다면 다음과 같이 아이콘을 지정할 수 있습니다:

pyinstaller --onefile --icon=your_icon.ico your_script.py

주의: 아이콘 파일은 .ico 형식이어야 하며, 스크립트와 같은 폴더에 있어야 합니다.

5. 콘솔 창 없애기 (GUI 전용 앱)

만약 콘솔창이 필요 없는 GUI 앱이라면, 아래 옵션으로 콘솔을 제거할 수 있습니다:

pyinstaller --onefile --windowed your_script.py

GUI 라이브러리(Tkinter, PyQt 등)를 사용하는 경우 이 옵션이 유용합니다.

6. 주의사항

• 실행 파일 용량이 클 수 있음 (수 MB ~ 수십 MB)
• 바이러스 오탐지 우려 → 디지털 서명 또는 압축 필요
• 외부 모듈 포함 여부에 따라 실행 시 오류 발생 가능
• 라이브러리에 따라 빌드 실패 시 의존성 재설정 필요

문제가 발생할 경우 --clean 옵션이나 스펙 파일 수정을 통해 해결할 수 있습니다.

7. 예제: 간단한 메시지 창 EXE 만들기

# hello.py
import tkinter as tk
from tkinter import messagebox

root = tk.Tk()
root.withdraw()
messagebox.showinfo("알림", "파이썬 EXE 파일입니다.")

위 코드를 hello.py로 저장한 후 다음 명령어로 빌드합니다:

pyinstaller --onefile --windowed hello.py

이제 콘솔 없이 실행되는 EXE 파일이 완성됩니다.

마무리

PyInstaller는 파이썬으로 만든 앱을 윈도우 EXE로 쉽게 배포할 수 있도록 도와주는 강력한 도구입니다.
기본 사용법만 알아도 대부분의 상황에서 실행 파일을 만들 수 있으며, 다양한 옵션을 통해 유연하게 설정할 수 있습니다.
윈도우 사용자에게 앱을 배포하고 싶다면 EXE 변환은 필수 단계입니다.