PyCharm에서 파이썬을 윈도우 실행 파일(.exe)로 만드는 방법

PyCharm 환경에서 파이썬 스크립트를 독립된 윈도우 실행 파일(.exe)로 만드는 가장 표준적인 방법은 PyInstaller 라이브러리를 사용하는 것이다.

1. 준비 단계: 라이브러리 설치

PyCharm 하단의 Terminal 탭을 열고 아래 명령어를 입력하여 필요한 패키지를 설치한다.

pip install pyinstaller

2. 실행 파일 생성 (빌드)

터미널에서 변환하려는 메인 스크립트 파일이 있는 경로로 이동한 뒤, 다음 명령어를 입력합니다.

pyinstaller --onefile --noconsole main.py

• --onefile: 모든 라이브러리와 스크립트를 단 하나의 .exe 파일로 합칩니다.
• --noconsole: 프로그램 실행 시 검은색 터미널 창이 뜨지 않게 합니다. (GUI 프로그램일 경우 필수)
• main.py: 본인이 작성한 파이썬 파일 이름으로 변경하세요.

3. 결과 확인

작업이 완료되면 프로젝트 폴더 내에 몇몇 폴더가 생성된다.

• dist 폴더: 최종 생성된 .exe 파일이 들어있다. 이 파일만 복사해서 다른 윈도우 PC에서 실행하면 된다.
• build 폴더 / .spec 파일: 빌드 과정에서 생성된 임시 파일들로, 완료 후 삭제해도 상관없다.

---

💡 팁: 아이콘 추가하기

프로그램에 예쁜 아이콘을 넣고 싶다면 --icon=아이콘이름.ico 옵션을 추가한다.

pyinstaller --onefile --noconsole --icon=myicon.ico main.py