VS Code で「pandas がない」エラーが出たときの対処法|仮想環境の Python がズレているだけでした(Windows・VS Code・2025年12月)

この記事の内容について、業務や開発でお困りの場合は個別に対応できます。

作業を進めていると、VS Code のターミナルで import pandas が通らないのに、拡張機能側では「pandas をインストールしました」と表示される不思議な現象に遭遇することがあります。今回の実環境(Windows・VS Code・Python 3.13.7 venv)でもまさに同じ状態になりましたが、原因はとても単純でした。VS Code が “違う Python” を参照していたためです。

なぜ起きるのか

VS Code 上でパッケージをインストールすると、通常は .venv 配下に入ります。しかし、ターミナルを開いたときに参照される Python がシステムの Python(例:3.12 など)だと、仮想環境に入れた pandas を見つけられません。その結果、ModuleNotFoundError: No module named 'pandas' が発生します。

どう直したか

最も確実だったのは、VS Code に「正しい Python を使うように指定し直す」ことでした。左下の Python バージョン表示をクリックし、.venv の Python を選び直すと状況が改善します。あわせて、ターミナルで .venv\Scripts\activate を実行し、仮想環境が正しく有効化されているか確認しました。その後 pip install pandas openpyxl を再実行するとエラーは消えました。

作業時に意識したいポイント

VS Code は複数の Python を保持している環境だと、自動検出がうまく働かないことがあります。パッケージ関連のエラーが出たときはまず “どの Python を使っているか” を確認するのが近道です。仮想環境を選び直すだけで、多くの場合スムーズに解決できます。

ZIDOOKA!

この記事の内容について、対応できます

この記事に関連する技術トラブルや開発上の問題について個別対応を行っています。

個別対応は3,000円〜 内容・工数により事前にお見積りします
最後までお読みいただきありがとうございました

コメントを残す

メールアドレスが公開されることはありません。 が付いている欄は必須項目です

AI活用に関するポリシー

当サイトでは、記事の執筆補助にAIを活用する場合がありますが、全面的な委任は行いません。