できない.dev

VSCode で Python インタプリタが認識されない

VSCode で Python インタプリタが認識されないなら、Python: Select Interpreter で venv の python を選べば直る。
必要なら settings.json にパスを書いておく。

公開: 更新:

要約

VSCode のステータスバーに Select Interpreter と出る、もしくは実行ボタンが反応しないときは、Python 拡張機能がワークスペースに紐づくインタプリタを把握できていない。
コマンドパレットの 「Python: Select Interpreter」 で明示的にインタプリタを選び、必要なら .vscode/settings.json にパスを残す。

解決策

1. 拡張機能を最新版に揃える

Ctrl+Shift+X の拡張機能ビューで Python (ms-python.python) を検索し、インストールする。
すでに入っていたら一度無効化 → 有効化で再読み込みする。
Pylance も自動で入る。

2. コマンドパレットで明示選択

Ctrl+Shift+P → Python: Select Interpreter を実行し、.venv/bin/python(macOS/Linux)または .venv\Scripts\python.exe(Windows)を選ぶ。
公式の Environments ガイド(新しいタブで開く) に手順がある。

3. settings.json で固定する

チーム共有や CI を意識するなら .vscode/settings.json にパスを書く。

{
  "python.defaultInterpreterPath": "${workspaceFolder}/.venv/bin/python"
}

${workspaceFolder} を使うと OS や clone 先が変わっても解決できる。

4. Remote / WSL では再度選び直す

Remote-SSH / WSL で開いたウィンドウは別の VSCode セッションとして扱われ、Local 側の設定は引き継がれない。
Remote 側でも同じく Python: Select Interpreter を実行する。
リモートに venv を作ってからのほうが選択肢に現れやすい。

よくある原因

  1. 拡張機能が無いか、無効になっている。
    ms-python.python を入れ忘れている、または別プロファイルで無効化されている。
  2. インタプリタをまだ選んでいない。
    初回起動時に Select Interpreter を一度もやっていないと、venv やシステム Python が拾われない。
  3. インタプリタのパスが消えた。
    一度選んだ python.exe / .venv/bin/python を削除・再生成したまま、設定が古いパスを指している。
  4. Remote / WSL で文脈が違う。
    Local 側の VSCode ではインタプリタが見えるが、Remote-SSH / WSL で開いたウィンドウは別物として扱われる。