pyinstaller 반드시 추가해야할 필수 옵션 리스트

--clean, --no-cache-dir 옵션은 빌드 환경을 정리하고, 패키징 오류를 방지하기 위한 아주 중요한 옵션입니다.

 

---

✅ 1. --clean 옵션

기존 빌드/캐시 디렉토리를 깨끗하게 삭제하고 새로 빌드하라는 의미입니다.

• 이전 빌드에서 남은 임시 파일이 새로운 빌드에 영향을 주는 것을 방지합니다.
• 특히 .spec을 수정했을 때 필수입니다.

📌 효과:

• build/, __pycache__/, .pyc 등 내부 임시 캐시 모두 제거
• 깨끗한 상태에서 새 빌드 → 에러 감소

---

✅ 2. --no-cache-dir 옵션 대신 

 아래 폴더를 직접 삭제하자.

C:\Users\<계정명>\AppData\Local\pyinstaller

 

spec 파일 안에는 이 옵션을 직접적으로 넣을 수 없음

--clean, --no-cache-dir는 PyInstaller 커맨드라인 실행 옵션이지, .spec 파일 내부에 작성하는 옵션이 아님

🔸즉, spec 파일은 빌드 구성만 저장하고,

--clean, --no-cache-dir은 PyInstaller 명령어 실행 시 외부에서 전달해야 하는 설정입니다.

 

 

추천 옵션

--clean: 기존 빌드 디렉토리, 캐시 완전 삭제 후 새 빌드
--no-cache-dir: 내부 .pyc / pyz 캐싱 미사용 → 특히 SSL 관련 오류에 매우 효과적
--noconfirm: 덮어쓰기 자동화
--onedir: 폴더 구조 빌드 (원파일이 아니므로 디버깅 쉬움)
--console: 콘솔창 출력 허용 (GUI 프로젝트면 --windowed 사용)

 

사용예시

pyinstaller --clean --no-cache-dir --noconfirm --onedir --console ^
--add-data "C:\Users\usernae\OneDrive\문서\GitHub\Buffer_radio\config;config" ^
--add-data "C:\Users\usernae\OneDrive\문서\GitHub\Buffer_radio\cache;cache" ^
--add-data "C:\Users\usernae\OneDrive\문서\GitHub\Buffer_radio\modules;modules" ^
--add-data "C:\Users\usernae\OneDrive\문서\GitHub\Buffer_radio\sounds;sounds" ^
"C:\Users\skfka\OneDrive\문서\GitHub\Buffer_radio\start_radio.py"