「ModuleNotFoundError: No module named ‘distutils’」の解消方法 - リラックスした生活を過ごすために

はじめに

Pythonのバージョン3.10の実行環境を、バージョン3.12にアップデートしました。
アップデート後にプログラムを実行したところ、下記のエラーが発生しました。

ModuleNotFoundError: No module named 'distutils'

解消するための方法をまとめました。

楽天ブックス

¥2,420 （2025/04/23 17:29時点 | 楽天市場調べ）

＼楽天ポイント4倍セール！／

＼商品券4%還元！／

ポチップ

bookfan 1号店楽天市場店

¥3,190 （2025/04/22 11:31時点 | 楽天市場調べ）

＼楽天ポイント4倍セール！／

＼商品券4%還元！／

ポチップ

Pythonの環境にdistutilsモジュールがインストールされていないことを示しています。Python 3.10からdistutilsモジュールは非推奨とされ、Python 3.12での削除が予定されています。

distutilsの機能の多くは、setuptoolsによって拡張または置き換えられています。setuptoolsは、Pythonプロジェクトのビルド、配布、インストールを扱うためのツールです。

新しいPythonプロジェクトではsetuptoolsの使用が推奨され、既存のプロジェクトもdistutilsからsetuptoolsへの移行することが望ましいようです。

pipによるsetuptoolsのインストールは、下記となります。

(venv)> pip install setuptools

以上で「ModuleNotFoundError: No module named ‘distutils’」は解消できます。