Python バージョンの指定
この記事の英語版に更新があります。ご覧の翻訳には含まれていない変更点があるかもしれません。
最終更新日 2025年02月06日(木)
Table of Contents
新しく作成された Python アプリは、デフォルトで最新パッチバージョンの Python 3.13 を使用します。
Cedar 世代のアプリの場合、別のバージョンを指定するかビルドキャッシュをクリアしない限り、アプリの後続のビルドは最初の Python のメジャーバージョンに固定されます。
Fir 世代のアプリの場合、アプリの後続のビルドはその時点でデフォルトの Python バージョンを使用するため、使用されるバージョンは時間の経過と共に変わる可能性があります。
デフォルトバージョンに依存するのではなく、.python-version ファイルでアプリの Python バージョンを指定することを強くお勧めします。
ランタイムの選択
Python のランタイムを指定するには、使用する Python のバージョン番号を宣言する .python-version ファイル (ファイル名の先頭にある . に注意) を、アプリのルートディレクトリに追加します。
このバージョンは次のいずれかになります。
- Python のメジャーバージョン。例:
3.13 (推奨) - Python の完全なバージョン番号。例:
3.13.0
正確なバージョンに固定するのではなく、メジャーバージョン形式 (例: 3.13) を使用することを強くお勧めします。
こうすることで、自動的に最新の Python セキュリティアップデートを使用してアプリがビルドされるようになります。
たとえば、次のようになります。
$ cat .python-version
3.13
ローカルで実行している Python のバージョンを確認するには、仮想環境を有効にして python --version を実行します。
$ python --version
Python 3.13.0
runtime.txt ファイルは廃止されました。
アプリでこのファイルを使用している場合は、.python-version ファイルに切り替えることをお勧めします。
理由は、こちらのファイルのほうが、Python エコシステム内のほかのツールによって広くサポートされているためです。
サポートされているランタイムバージョン
「サポートされている Python バージョン」を参照してください。