この記事で解決すること
Pythonでコードを実行したら、こんなエラーが出た。
ModuleNotFoundError: No module named 'requests'
pip install requests したのに動かない。なぜ？
この記事では、このエラーの原因と「仮想環境」を使った根本的な解決方法を説明します。
なぜこのエラーが出るのか
PCに複数のPythonが入っていることが原因です。
たとえば：
- Python 3.10 と Python 3.12 が両方入っている
pip installしたのは3.10の方pythonコマンドで動くのは3.12の方
別々のPythonなので、片方にインストールしたライブラリはもう片方からは見えません。
解決方法：仮想環境を使う
「仮想環境（venv）」を使えば、プロジェクトごとに専用のPython環境を作れます。ライブラリの混乱がなくなります。
ステップ1: 仮想環境を作る
プロジェクトのフォルダで以下を実行します。
python -m venv .venv
.venv というフォルダが作られます。この中に、このプロジェクト専用のPythonが入ります。
venv は「virtual environment（仮想環境）」の略です。
ステップ2: 仮想環境を有効にする
Windowsの場合：
.venv\Scripts\activate
Mac / Linuxの場合：
source .venv/bin/activate
成功すると、ターミナルの先頭に (.venv) と表示されます。
(.venv) C:\Users\あなた\project>
ステップ3: ライブラリをインストールする
仮想環境が有効な状態で pip install します。
pip install requests
これで、この仮想環境の中にだけ requests がインストールされます。
ステップ4: コードを実行する
python your_script.py
ModuleNotFoundError は出なくなります。
毎回activateするのが面倒な場合
VS Codeを使っているなら、自動で仮想環境を認識してくれます。
- VS Codeでプロジェクトフォルダを開く
- 右下のPythonバージョンをクリック
.venvのPythonを選択
これで、VS Code内のターミナルでは自動的に仮想環境が有効になります。
仮想環境を終了するとき
deactivate
これだけです。
まとめと次のステップ
ModuleNotFoundErrorは「そのPythonにはライブラリが入っていない」という意味- 仮想環境を使えば、プロジェクトごとにライブラリを管理できる
python -m venv .venv→activate→pip installの3ステップ
慣れると、新しいプロジェクトを始めるときに無意識にやるようになります。
関連リソース
Pythonをもっと学びたい方へ：
リンク