Python バージョンの指定

Table of Contents [expand]

この記事の英語版に更新があります。ご覧の翻訳には含まれていない変更点があるかもしれません。

最終更新日 2025年05月04日(日)

新しく作成された Python アプリは、デフォルトで最新パッチバージョンの Python 3.13 を使用します。

Cedar 世代のアプリの場合、別のバージョンを指定するかビルドキャッシュをクリアしない限り、アプリの後続のビルドは最初の Python のメジャーバージョンに固定されます。

Fir 世代のアプリの場合、アプリの後続のビルドはその時点でデフォルトの Python バージョンを使用するため、使用されるバージョンは時間の経過と共に変わる可能性があります。

デフォルトバージョンに依存するのではなく、.python-version ファイルでアプリの Python バージョンを指定することを強くお勧めします。

Python バージョンを指定するには、使用する Python バージョン番号を宣言する .python-version ファイルをアプリのルートディレクトリに追加します。

この Python バージョンは以下のいずれかになります。

正確なパッチバージョンに固定するのではなく、Python のメジャーバージョン (3.13 など) のみを指定することを強くお勧めします。これにより、アプリはビルドするたびに Python セキュリティアップデートを自動的に受信できるようになります。

たとえば、次のようになります。

$ cat .python-version
3.13

ローカルで実行している Python のバージョンを確認するには、仮想環境を有効にして python --version を実行します。

runtime.txt ファイルは廃止されました。アプリでこのファイルを使用している場合は、.python-version ファイルに切り替えることをお勧めします。理由は、こちらのファイルのほうが、Python エコシステム内の他のツールによって広くサポートされているためです。