ひよペンIT用語
ひよペンIT
Home
コラム
用語集
検索
Ctrl K
用語・読み方・別名
閉じる
調べたいIT用語を入力してね
もっと見る
再試行
·
全用語一覧から探す
wheel(Pythonの配布形式)
ほいーる
プログラミング
用語集
› 💻 プログラミング › wheel(Pythonの配布形式)
【ほいーる】
wheel(Pythonの配布形式) とは?
公開:
2026年11月3日
💡 Pythonパッケージを、インストール用に組み立てて届けるファイル形式
📌 このページのポイント
拡張子
は.whlで、中身は
ZIP
形式。
pip
などのインストーラで環境へ導入する
ファイル名のタグが、対応する
Python
・ABI(
バイナリ
の互換条件)・OSなどの環境を示す
対応するwheelがないと、
pip
はソース配布物からwheelをビルドして導入する場合がある
Cや
Rust
の
コンパイル
済み拡張だけでなく、
Python
の.pyファイルを含むwheelもある
wheelはインストール用の配布ファイル
環境に対応するwheelがある場合
.whl
組み立て済み
pip
Python
環境
ソース配布物から作る場合
sdist
元のコード
ビルド
.whl
できたwheelをpipで環境へ導入
wheelの中身は、.pyの場合も
コンパイル済みの拡張の場合もある
対応wheelがあれば、利用者側でそのパッケージをソースから組み立てる工程を省けます。ソース配布物から作る場合は、拡張の言語などに応じたビルド環境が必要です。
ひよこ
パッケージをダウンロードしたら、.whlというファイルだったよ。
ペンギン先生
wheel形式だね。
Python
の環境に入れるファイルを、
インストール
しやすい形でまとめた配布物だよ。
pip
などが中身を必要な場所へ配置するんだ。
ひよこ
.
tar
.gzで配られているものとは違うの?
ペンギン先生
Python
のソース配布物はsdistと呼ばれ、元のコードなどを含むよ。
pip
がそれを使う場合は、まずwheelをビルドする。対応するwheelが配られていれば、その組み立てを省けるんだ。
ひよこ
同じパッケージなのに、別のPCでビルドが始まるのはなぜ?
ペンギン先生
そのPCの
Python
やOS、
CPU
に合うwheelが用意されていない可能性があるよ。ソースから作る場合、含まれる拡張によってはCや
Rust
の
コンパイラ
なども必要になるんだ。
ひよこ
wheelの中身は、全部
コンパイル
済みの機械語?
ペンギン先生
そうとは限らないよ。
Python
だけで書かれたパッケージなら.pyファイルを含むものもある。wheelは配布形式の名前で、中身の
プログラミング言語
を一つに決める名前ではないんだ。
まとめ:ざっくりこれだけ覚えればOK!
「
Python
のwheel」って出てきたら「
インストール
用に組み立てたパッケージの配布ファイル」と思えばだいたいOK!
🔗 あわせて読みたい
pip とは?
Python とは?
uv とは?
参考資料
Python Packaging User Guide — Wheel distribution format
Python Packaging User Guide — パッケージフォーマット
Databricks — ジョブのPython wheel タスク
誤り・わかりにくい説明を報告する
シェアする
X
URLコピー
← 用語集にもどる