Hatch vs PDM: Python プロジェクトマネージャー比較
高速な resolver、組み込みの lockfile、PEP 582 スタイルのローカルインストールが欲しいなら PDM を、標準化された build backend、環境マトリクス、プロジェクトのスクリプティングを 1 つのツールで欲しいなら Hatch を選びましょう。
Hatch (PyPA 製) と PDM は、どちらも古い setup.py + virtualenv + pip のフローを置き換える、モダンで標準ベースの Python プロジェクトマネージャーです。両者は多くの点で重なりますが、強調する点が異なります。Hatch は再現可能な環境とその hatchling build backend を中心にしており、PDM は高速な依存関係 resolver とコミットされた lockfile (pdm.lock) を中心にしています。どちらも pyproject.toml を読み取ります。
| Hatch | PDM | |
|---|---|---|
| 設定 | pyproject.toml ([tool.hatch]) | pyproject.toml ([tool.pdm]) |
| Lockfile | 組み込みの lock なし (hatch-pip-compile または外部を使用) | pdm.lock を組み込み |
| Build backend | hatchling (人気のスタンドアロン backend) | pdm-backend |
| 環境 | 名前付き環境とテストマトリクス | 単一のプロジェクト venv (プロジェクト内 .venv) |
| スクリプト/タスク | hatch run + scripts | pdm run + scripts |
| 標準 | PEP 517/518/621 | PEP 517/518/621、PEP 582 の履歴 |
それぞれが本当に勝る場面
PDM は、追加のツールを付け足さずに、コミットされたクロスプラットフォームの lockfile と高速な resolver が欲しいときに勝ちます。その pdm.lock と pdm install のフローは、そのままで再現可能です。Hatch は、パッケージを公開し、クリーンで広く採用された build backend (hatchling) に加えて、1 つの CLI で管理されるテスト環境のマトリクスが欲しいときに勝ちます。日々のワークフローが pip や uv であっても、多くのプロジェクトが hatchling を build backend として使っています。
CI において
PDM は CI で便利です。pdm install が pdm.lock から正確でロックされた環境を復元するからです。Hatch では、lock の再現性は通常 pyproject.toml でのピン留め、または pip-tools/uv との組み合わせから得られます。CI におけるその強みは、同じ hatch run test マトリクスをローカルと runner の両方で実行できることです。
正直な注意点
どちらも普遍的に「優れている」わけではありません。Hatch は意図的にロックをやや外部に委ねており、それを嫌うチームもあります。PDM はより多く (lock、scripts、plugins) をまとめますが、それは PDM 固有の概念を学ぶ必要が増えることを意味します。急速に進化する uv ツールは両者と重なるため、コミットする前に評価してください。
Decide with your own numbers, not a feature table
Feature comparisons age badly and rarely decide anything, because both tools in a mature category can do the job. What differs is how each behaves on your repository, and that takes one afternoon to measure.
# time a cold install with each candidate, cache cleared
hyperfine --prepare "rm -rf node_modules" --warmup 1 \
"<tool-a> install" "<tool-b> install"
# and the thing CI actually pays for: a cold run with no local cache
docker run --rm -v "$(pwd):/w" -w /w node:22 sh -c "<tool> install"What actually changes when you switch
- Lockfile format. A switch is a one-way door for anyone still on the old tool until everyone migrates, so plan it as a single coordinated change.
- Resolution strictness. Tools differ on whether an undeclared transitive import works, and the stricter one will surface latent bugs as new failures.
- CI cache configuration. The cache path and key differ per tool; carrying over the old ones silently disables caching.
- Everyone on the team and every runner must move together. Pin the version so they cannot drift.
結論
標準の build backend と環境マトリクスを求めるライブラリ作者には、Hatch がよく合います。組み込みの lockfile と高速な resolver を 1 つのツールで求めるアプリケーションチームには、PDM がより完成度の高いデフォルトです。