【解決法】Pythonインストール時の「コマンド python setup.py egg_info がエラーコード1で失敗しました」エラーの対処方法

Pythonでパッケージをインストールする際に表示される「コマンド "python setup.py egg_info" がエラーコード1で失敗しました」というエラー。エラーコード1は、Python標準のerrnoシステムシンボルにおいて「操作が許可されていません（Operation not permitted）」として定義されています。

この問題は、主にsetuptoolsがインストールされていない、または古いバージョンのままであることが原因で発生します。本記事では、実際に多くのユーザーがこのエラーを解決できた具体的な対処方法を順番にご紹介します。

pipとsetuptoolsが正しくインストールされているか確認する

アップデート作業を行う前に、まずお使いのシステムにpipとsetuptoolsがインストールされているかどうかを確認しましょう。バージョン番号も同時に確認できるため、pipやsetuptoolsが最新版から遅れていることでエラーが発生しているのかどうかを判断できます。

以下の手順でインストール済みのバージョンを確認してください。

1. Windowsの検索機能で「コマンドプロンプト」を検索して起動します。
2. 次のコマンドを入力して、インストール済みパッケージの一覧を表示します。

   pip list

3. 一覧の中にsetuptoolsが表示されていれば、すでにシステムにインストールされていることを意味します。バージョン番号を確認し、最新版と比較してみてください。

setuptoolsをアップグレードする

setuptoolsがすでにインストールされている場合は、最新バージョンへの更新を試みましょう。古いsetuptoolsはegg_info関連のエラーの原因になることがあります。以下の手順で更新できます。

1. Windowsの検索機能で「コマンドプロンプト」を検索して起動します。
2. 次のコマンドを入力してsetuptoolsを更新します。

   pip install --upgrade setuptools

   注意： macOSやLinuxなどのターミナル環境で実行する場合は、コマンドの先頭に「sudo」を付けてください。

3. 「successfully installed」というメッセージが表示されれば成功です。その後、最初にエラーが出たコマンドを再度実行してみてください。

pip自体をアップグレードする

場合によっては、問題がpip本体にあることもあります。pipを最新版にアップグレードすることで解決するケースがあります。以下の手順を実行してください。

1. Windows + Sキーを押してWindows検索を開き、「コマンドプロンプト」を検索して起動します。
2. 次のコマンドを入力してpipを更新します。

   python -m pip install -U pip

3. 更新完了後、pipコマンドを使って目的のパッケージを再びインストールしてみてください。

ez_setupをインストールしてみる

ez_setupモジュールをインストールすることで問題が解決したというユーザーもいます。このモジュールがシステムに存在しないことが、エラーの原因となっている場合があるためです。実際に多くの方がこの方法で解決しています。

1. Windowsキーを押しながらRキーを押して「ファイル名を指定して実行」ダイアログを開きます。「CMD」と入力してEnterキーを押し、コマンドプロンプトを起動します。
2. 次のコマンドを入力してez_setupをインストールします。

   pip install ez_setup

3. バージョン名とともに「successfully installed」のメッセージが返ってくれば成功です。その後、パッケージのインストールコマンドを再度実行し、正常に動作するか確認してください。