Cannot uninstall numpy 1.21.2, RECORD file not foundの解決方法【2025年最新版】

エラーの概要・症状

Pythonを使用していて、NumPyパッケージをアンインストールしようとした際に「Cannot uninstall numpy 1.21.2, RECORD file not found」というエラーメッセージが表示されることがあります。このエラーは、NumPyのインストールが正常に行われていないか、RECORDファイルが見つからないために発生します。RECORDファイルは、インストールされたパッケージのメタデータを格納している重要なファイルであり、これが欠けているとpipはアンインストールを適切に行えません。

このエラーが発生すると、以下のような症状が見られます：

• NumPyをアンインストールしようとするが、エラーが発生して実行できない。
• 他のパッケージのインストールやアップグレードができなくなる可能性がある。
• 特にCUDAなどの依存関係を持つパッケージのインストール時に問題が発生することが多いです。

ユーザーにとっては、NumPyのバージョンを変更したい場合や依存関係の整理を行いたい場合に大きな障害となります。特にデータサイエンスや機械学習のプロジェクトを進めている方にとって、このエラーは非常に厄介です。

このエラーが発生する原因

このエラーが発生する原因はいくつか考えられます。以下に主な原因を示します。

1. RECORDファイルの欠如: NumPyがインストールされた際にRECORDファイルが正常に作成されなかった場合、このファイルが存在しないため、pipはアンインストールの手続きを進められません。

2. 不完全なインストール: 他のパッケージのインストール中にエラーが発生し、その影響でNumPyが正常にインストールされなかった場合もこのエラーが発生します。特に、依存関係が多いパッケージの場合、この問題が起こりやすくなります。

3. バージョンの不整合: 特定のNumPyバージョンが他のライブラリと競合している場合、アンインストールが困難になることがあります。特にCUDAやその他のライブラリと併用している場合、これが原因でエラーが発生することがあります。

4. 環境の設定ミス: 環境変数やパスの設定が不適切な場合も、NumPyのアンインストールに影響を及ぼすことがあります。特に、複数のPython環境が存在する場合、意図しない環境でのコマンド実行が原因となることがあります。

解決方法1（最も効果的）

手順1-1（具体的なステップ）

まずは、NumPyを強制的にアンインストールする方法を試みます。以下のコマンドをターミナルまたはコマンドプロンプトで実行してください。

pip uninstall numpy

このコマンドでエラーが発生する場合、次の手順に進みます。

手順1-2（詳細な操作方法）

NumPyの関連ファイルを手動で削除する方法があります。これには以下の手順が含まれます：

1. Pythonのサイトパッケージフォルダを見つけます。通常、次のようなパスになります：

• Linux/Mac: ~/.local/lib/pythonX.X/site-packages/

• Windows: C:\Users\ユーザー名\AppData\Local\Programs\Python\PythonX.X\Lib\site-packages\

• X.XはPythonのバージョンです。

1. 上記のフォルダ内にあるnumpyフォルダとnumpy-X.X.X.dist-info（X.X.Xはバージョン番号）を削除します。

2. 再度、NumPyをインストールします。

pip install numpy

注意点とトラブルシューティング

• 手動で削除する際は、他の依存パッケージに影響を与えないよう注意してください。
• Pythonの複数環境がある場合は、正しい環境で作業しているか確認してください。

解決方法2（代替手段）

もし上記の方法で解決できない場合、NumPyの古いバージョンをインストールすることも考えられます。以下の手順で行います。

1. 現在のNumPyをアンインストールします。エラーが出る場合は、手動で削除を行います。

2. 次に、古いバージョンのNumPyをインストールします。例えば、次のコマンドを実行します。

pip install numpy==1.19.3

この方法で解決できる場合もありますので、一度試してみてください。

解決方法3（上級者向け）

上級者向けの方法として、環境を完全にクリーンにするために、仮想環境を使用することをお勧めします。以下の手順で行います。

1. 新しい仮想環境を作成します。

python -m venv myenv

1. 仮想環境をアクティブにします。

• Linux/Mac:

source myenv/bin/activate

• Windows:

myenv\Scripts\activate

1. この新しい環境内でNumPyをインストールします。

pip install numpy

この方法では、環境を分けることで干渉を避けることができるため、エラーの発生を防ぐことができます。

エラーの予防方法

今後同様のエラーを防ぐためには、以下の対策を講じることが重要です：

• **定期的な環境の整理**: 不要なパッケージや古いバージョンを定期的に整理し、依存関係をクリアに保ちましょう。
• **仮想環境の利用**: プロジェクトごとに仮想環境を作成し、依存関係を管理することで、異なるプロジェクト間の干渉を避けることができます。
• **パッケージ管理ツールの活用**: pipだけでなく、condaなどの他のパッケージ管理ツールも検討し、より柔軟な管理を行うことができます。

関連するエラーと対処法

このエラーに関連する問題として、以下のエラーが考えられます：

• **Could not install packages due to an OSError**: このエラーは、ファイルシステムの権限や依存関係の不整合が原因で発生します。対処法としては、権限を確認したり、依存関係を整理することが挙げられます。
• **Permission denied**: アンインストールやインストール時に権限が無い場合に発生します。この場合は、sudoを使用して管理者権限でコマンドを実行します。

まとめ

今回は「Cannot uninstall numpy 1.21.2, RECORD file not found」のエラーについて、その原因と解決方法を詳しく解説しました。エラーが発生する原因は多岐にわたりますが、手動での削除や仮想環境の利用が有効です。また、今後同様のトラブルを避けるためには、定期的な環境の整理やパッケージ管理が重要です。次のステップとして、仮想環境を作成し、クリーンな状態で作業を進めることをおすすめします。