Pythonでコードを書いていて、誰もが一度は遭遇する「ModuleNotFoundError」。
せっかくやる気を出してプログラムを動かそうとしたのに、赤文字でドカンとエラーが出ると「あ、もう無理かも…」って心が折れそうになりますよね。
現役エンジニアの僕も、新人の頃はこのエラーに何度も泣かされました。
でも安心してください。このエラー、実は「その道具（ライブラリ）がどこにあるか分からないよ！」とPythonが困っているだけなんです。
今回は、このエラーをコピペで最速解決するための手順を、どこよりも分かりやすく解説します！
1. まずはこれを試して！魔法の解決コマンド
エラーメッセージの最後に No module named '〇〇' と書いてありますよね？
その「〇〇」の部分をコピーして、以下のコマンドをターミナル（WindowsならコマンドプロンプトやPowerShell、Macならターミナル）に貼り付けるだけです。
bash
pip install 〇〇
例：No module named ‘pandas’ と出た場合
bash
pip install pandas
これで解決すれば、あなたはもう自由です！お疲れ様でした。
もし「これでも直らない…」という場合は、次のステップへ進みましょう。
2. インストールしたはずなのにエラーが出る理由
「さっき pip install したのに、まだエラーが出る！」というパターン。これが一番厄介ですよね。
原因は主に2つです。
原因A：複数のPythonがパソコンに入っている
パソコンの中に「Python A」と「Python B」が同居していて、「Aにインストールしたのに、Bで実行しようとしている」状態です。
【解決策】
以下のコマンドで、実行するPythonを直接指定してインストールしましょう。
bash
python -m pip install 〇〇
※Windowsでうまくいかない場合は python の部分を py に変えてみてください。
原因B：VS Codeの「インタープリター」が違う
VS Codeを使っている初心者が最もハマるポイントです。
右下の「Python 3.x.x…」と書いてある場所をクリックして、「(venv)」や「(Global)」などの設定が、インストールした場所と合っているか確認してください。
3. よくある「うっかりミス」をチェック
意外と多いのが、技術的な問題ではなく「ちょっとした書き間違い」です。
- スペルミスはありませんか？
pandasをpandsと書いていないか確認しましょう。- ファイル名がライブラリと同じになっていませんか？
pandas.pyという名前のファイルを自分で作ってしまうと、Pythonが「自分自身を読み込もう」としてエラーになります。ファイル名を変えましょう。
4. 【効率化のコツ】チームや別PCでも困らないために
エンジニアが現場でよく使う「一括インストール」の方法も教えちゃいます。
これを知っておくと、複数のライブラリを使う時に一個ずつインストールする手間が省けて楽ですよ。
- プロジェクトのフォルダに
requirements.txtという名前のテキストファイルを作ります。 - 必要なライブラリ名を一行ずつ書きます。
- 以下のコマンドを実行します。
bash
pip install -r requirements.txt
これだけで、必要なものが一気に揃います。まさに時短テクニック！
まとめ
ModuleNotFoundError は、決してあなたの才能が足りないわけではありません。単に「道具の場所を教えてあげる」だけで解決します。
pip install 〇〇を試すpython -m pip install 〇〇を試す- VS Codeの設定（インタープリター）を確認する
- ファイル名とライブラリ名が被っていないか見る
この4ステップで、Pythonエラーの8割は撃退できます。
エラーを怖がらず、どんどんコードを書いて効率化していきましょう！
もし「どうしても解決しない！」ということがあれば、エラー文を丸ごとAIに投げたり、周りのエンジニアに頼るのも立派なスキルですよ。応援しています！
コメント