用語集 最終更新 2026.04.04

pyproject.toml

pyproject.toml は、Python プロジェクトの設定や依存情報をまとめるための標準的な設定ファイルです。
最近の Python ツールでは、このファイルを中心にプロジェクト設定を持つことがかなり増えています。

まず押さえたいポイント

  • プロジェクト設定の中心になるファイル
  • 依存関係やビルド設定を持てる
  • Poetryuv でよく出てくる

どんな場面で使うか

  • 依存関係の定義
  • ツール設定の集約
  • パッケージ公開やビルド設定

どんなふうに理解するとよいか

Python プロジェクトの設定をまとめて置く場所 と考えると分かりやすいです。
以前より setup.py やバラバラの設定ファイルに分かれていたものを整理しやすくしています。

押さえておきたい注意点

何でも書けるぶん、ツールごとに使う項目が違います。
そのため、どのツールがどの設定を読むのかは分けて考えた方が安全です。

実務で見るポイント

  • Python プロジェクトの標準的な入口になりやすい
  • ツール設定をまとめて見やすい
  • ロックファイルとは役割が違う

この用語を読むときのコツ

pyproject.toml は単語だけ暗記するより、「どんな場面で出てくるか」「何と一緒に語られるか」をセットで押さえた方が理解しやすいです。記事や設定画面で見かけたら、何を決めるための用語なのかまで見ると意味がつながりやすくなります。

最初のうちは、このページだけで完結させようとしなくて大丈夫です。 下の関連用語や関連記事も一緒にたどると、pyproject.toml がどの文脈で使われる言葉なのかがかなり見えやすくなります。

あわせて見たい用語