wheel(.whl)은 「사전 빌드된 파이썬 패키지」 형식입니다.

pip install이 매번 컴파일 안 하고 wheel을 받아 즉시 설치 가능 — 설치 속도와 안정성이 크게 개선됩니다.

기존 방식의 문제.

옛날엔 source distribution(sdist, .tar.gz)만 있어서 pip install 할 때마다 컴파일.

C 코드 의존하는 패키지(NumPy 등)는 사용자 환경에 컴파일러·헤더 없으면 실패.

wheel의 등장(PEP 427).

미리 컴파일해 둔 바이너리.

.whl 파일은 「플랫폼·파이썬 버전」별로 따로 — numpy-1.24.0-cp310-cp310-macosx_10_9_x86_64.whl 식.

pip가 자동으로 환경에 맞는 걸 선택.

빌드.

패키지 작성 시 python -m build로 .whl 자동 생성.

C 확장 없는 순수 파이썬은 「universal wheel」(any 플랫폼).

C 확장 있으면 cibuildwheel 같은 도구로 여러 플랫폼용을 자동 빌드.

manylinux.

리눅스 wheel은 「manylinux1·manylinux2014·manylinux_2_28」 같은 표준이 있어 「대부분의 리눅스 배포판에서 동작」 보장.

NumPy·SciPy 같은 C 확장 패키지가 모두 manylinux wheel을 제공해 즉시 설치됩니다.

한 줄 요약

wheel(.whl)은 사전 빌드된 패키지로 pip 설치가 매번 컴파일 없이 즉시.

플랫폼·버전별 따로, manylinux 표준으로 리눅스 호환성 확보.

cibuildwheel로 다중 플랫폼 자동 빌드.

더 알아볼 것

- sdist vs wheel 차이

- cibuildwheel — CI에서 wheel 빌드

- pure Python wheel — universal