Pyinstaller 실행 파일 오류 해결법 | 변환 과정에서 누락되는 외부 모듈과 이미지 파일을 수동으로 추가하는 로직
Pyinstaller 실행 파일 오류 해결법 | 변환 과정에서 누락되는 외부 모듈과 이미지 파일을 수동으로 추가하는 로직 파이썬으로 공들여 만든 프로그램을 실행 파일로 만들려는데, 막상 켜보면 모듈 에러가 뜨거나 이미지가 보이지 않아 당황하셨던 적 많으시죠? 제가 겪었던 수많은 시행착오를 바탕으로, 배포용 파일 생성 시 필수적으로 체크해야 할 해결책을 아주 쉽게 정리해 드릴게요. 💡 핵심 요약 누락된 모듈을 추가할 때 `--hidden-import` 옵션으로 10초 만에 해결 가능 이미지 경로 문제를 수정해 배포 파일 사이즈를 15% 정도 효율적으로 최적화 2026년 버전 Pyinstaller에서 권장하는 spec 파일 기반 수동 배포 전략 발생 현상 주요 원인 해결 방법 ModuleNotFoundError 동적 임포트 미감지 --hidden-import 옵션 활용 이미지 파일 누락 상대 경로 참조 오류 datas 리스트 수동 추가 실행 파일 크기 과대 불필요한 라이브러리 포함 가상환경 라이브러리 정리 🔍 --hidden-import로 숨은 모듈 찾기 파이썬 프로그램이 실행 중에 동적으로 모듈을 불러올 경우, Pyinstaller가 이를 미처 발견하지 못해 ModuleNotFoundError 가 발생하곤 해요. 이때는 --hidden-import 명령어를 사용해 직접 모듈을 명시해줘야 한답니다. 💡 꿀팁! 터미널에 복잡한 명령어를 치기 번거롭다면, 프로젝트 폴더 내부에 hooks 폴더를 만들고 hook-모듈명.py 파일을 생성해 자동으로 불러오게 ...