VSCodeでPythonインタープリタが選択できない時の対処法|原因を6つに切り分ける

まず、どの症状かを確かめる

切り分けの前に、いま自分がどの状態なのかをはっきりさせます。VSCodeでCtrl+Shift+Pを押し、「Python: Select Interpreter」(日本語表示なら「Python: インタープリターを選択」)と入力してください。

該当する番号のところから読んでいただいても構いませんが、上から順に確認するほうが確実です。原因は重なっていることがあります。

中の人

ここから原因を1つずつ見ていくよ。上で当てはまったところだけ読めば大丈夫。全部読まなくていいからね。

原因1: Python拡張機能が入っていない

いちばん多い原因です。VSCodeは、そのままではPythonを扱えません。拡張機能を入れて初めて、インタープリタの選択や実行ができるようになります。

確認と対処

1. 左端のアイコンが並んだ列(アクティビティバー)から、四角が4つ並んだアイコン(拡張機能)をクリック
2. 検索欄に Python と入力
3. 発行元が「Microsoft」のものを選んでインストール

インストール後、VSCodeを一度完全に閉じて開き直します。これを飛ばすと、入れたのに認識されません。アイコンもバージョン表示も出ているのに、コマンドだけが出てこない——という紛らわしい状態になります(2026年9月に実機で確認)。

原因2: そもそもPythonが入っていない

拡張機能は「入っているPythonを探して一覧に出す」道具です。探す対象が無ければ、一覧は空になります。

確認しましょう。コマンドプロンプトを開いて、次を実行します。

python --version

バージョン番号が出れば入っています。次のような表示になったら、入っていません。

Python was not found; run without arguments to install from the Microsoft Store...

すでにPythonを入れたはずなのにこの表示が出る場合は、PATHが通っていません。入れ直すのがいちばん早いです(上のチェックを入れて再インストール)。なおpipまで認識されない場合は「ModuleNotFoundErrorとpipが認識されない時の対処法」で詳しく扱っています。

原因3: ユーザー名に日本語や全角スペースが入っている

これが、日本語環境のWindowsで特に起こりやすい原因です。そして厄介なことに、設定を見直しても絶対に見つかりません。原因がPythonにもVSCodeにも無いからです。

何が起きているのか

Windowsのユーザー名が「山田 太郎」のように日本語や全角スペースを含んでいると、あなたのファイルはこういう場所に置かれます。

C:\Users\山田 太郎\Documents\...

Pythonや拡張機能は、この全角文字を含むパスをうまく扱えないことがあります。結果として、Pythonは存在するのに「見つからない」という状態になります。

自分が該当するか確認する

コマンドプロンプトで次を実行してください。

echo %USERPROFILE%

表示されたパスに日本語・全角スペース・記号が含まれていないかを見ます。

対処法

いちばん確実なのはユーザー名を半角英数に変えることですが、既存ユーザー名の変更はWindowsでは危険を伴う作業です(アプリの設定が壊れることがあります)。おすすめしません。

現実的な対処は次の2つです。

• 作業フォルダを、ユーザーフォルダの外に置く — たとえば C:\dev\myproject のように、すべて半角英数のパスにプロジェクトを作る。これだけで解決することが多くあります
• Pythonを全ユーザー向けにインストールし直す — インストーラーで「Install for all users」を選ぶと、C:\Program Files\Python3xx のような、ユーザー名を含まない場所に入ります

中の人

ここがいちばん見つけにくいところ…。やってることは何も間違ってないのに詰まるやつだよ。

原因4: フォルダを開かずにファイル単体で開いている

意外と多いのがこれです。VSCodeは「フォルダを開いている状態」と「ファイル1つだけ開いている状態」で挙動が変わります。

ファイルをダブルクリックして開いただけだと、VSCodeはそのファイルがどのプロジェクトに属するか分かりません。仮想環境の検出も効かず、設定も保存先がない状態になります。

このとき、一覧が空になるわけではありません。システムに入っているPythonは、いつもどおり出てきます。消えるのは、そのフォルダの仮想環境(.venvなど)だけです。「一覧は出ているのに、使いたい仮想環境だけが無い」——これが原因4の症状です(2026年9月に実機で確認)。

確認と対処

VSCodeの左端、いちばん上のアイコン(エクスプローラー)を開いてください。

• 「開いているフォルダーがありません」(その下に「まだフォルダーを開いていません。」)と出ている → これが原因です
• フォルダ名とその中身が並んでいる → 問題ありません

対処は簡単で、メニューの「ファイル」→「フォルダーを開く」から、作業用フォルダを開き直すだけです。ファイル単体ではなくフォルダごと開くのが、VSCodeの基本の使い方になります。なお「ワークスペース」として開いている場合は、メニューの項目名が変わります。「フォルダーを閉じる」ではなく「ワークスペースを閉じる」です(タイトルバーに「(ワークスペース)」と付いていたら、そちらになります)。

原因5: 仮想環境の置き場所が違う

仮想環境(venv)を使っている場合の話です。使っていなければ、この項目は飛ばして構いません。

VSCodeは仮想環境を自動で探してくれますが、探す場所が決まっています。基本は「開いているフォルダの直下」です。

作り直すなら、プロジェクトフォルダの直下で次を実行します。

python -m venv .venv

作成後、VSCodeを再起動してください。再起動しないと検出されないことがあります。多くの場合、これだけで一覧に出てくるようになります。

原因6: 拡張機能の検出がおかしくなっている

ここまで全部当てはまらない場合、拡張機能側の状態が壊れている可能性があります。Pythonを入れ直した直後や、複数バージョンを入れ替えた後に起きやすい症状です。

次の順に試してください。上ほど手軽です。

1. VSCodeを完全に終了して開き直す — ウィンドウを閉じるだけでなく、タスクバーからも終了させる
2. コマンドパレットから再読み込み — Ctrl+Shift+P →「Developer: Reload Window」
3. Python拡張機能を無効化 → 有効化 — 拡張機能の画面から、いったん無効にして戻す
4. Python拡張機能をアンインストール → 再インストール — ここまでやれば、たいてい直ります

中の人

ここまでで直らなかった人へ。次が最後の手だから、もう少しだけ付き合ってね。

それでも出ないとき: パスを手で指定する

6つとも試して出ない場合、自動検出をあきらめて、場所を直接教える方法があります。

1. Pythonの実際の場所を調べる

コマンドプロンプトで実行します。

where python

次のようなパスが表示されます。

C:\Users\eugene\AppData\Local\Programs\Python\Python312\python.exe

2. VSCodeに直接指定する

1. Ctrl+Shift+P →「Python: Select Interpreter」
2. 一覧の先頭にある「Enter interpreter path…」(インタープリターのパスを入力)を選ぶ
3. 先ほど調べたパスを貼り付ける

これで、一覧に出てこなくても使えるようになります。

よくある質問

まとめ

「インタープリタが選択できない」は1つの症状ですが、原因は複数あります。上から順に確認してください。

特に原因3は、設定をどれだけ見直しても見つかりません。Pythonにも VSCodeにも問題が無いからです。心当たりがある方は、まずecho %USERPROFILE%を確認してみてください。

それでも解決しない場合、複数のPythonが混在していて全体が絡まっている可能性があります。そのときは環境そのものの整理から始めたほうが早いです。詳しい手順は「python環境がぐちゃぐちゃになったら読む記事」でまとめています。

中の人

おつかれさま!どこで詰まって、何をしたら直ったかをメモしておくと、次に同じ目にあったとき一瞬で終わるよ。