.python-version ファイルとは?

.python-version ファイルの解説。何をするものか、そして CI/CD でなぜ重要かを含みます。

.python-version ファイルは、プロジェクトが使う Python のバージョンを宣言し、pyenv が読み取ります。

何であるか

ローカルと CI で同じインタプリタのバージョンを保証し、Python のリリース間の微妙な動作の違いを避けます。

CI/CD でなぜ重要か

CI では、actions/setup-python が python-version-file を介してそれを読み取れるため、runner が対応するインタプリタをインストールします。

重要なポイント

• .python-version は Python のバージョンを固定します。
• pyenv と setup-python がそれを読み取ります。
• インタプリタのバージョンを一貫させます。

関連ガイド