Ir al contenido

Pythonと.venvのVS Code設定

VS Codeを使用した解釈と仮想環境のトラブルシューティング under Windowsシステム

0閲覧数

このガイドでは、Windows 環境下で Visual Studio Code における Python 開発環境を診断、構成、実装する決定的な技術手順を提供します。winget や Microsoft Store のような非標準パスを含むグローバル インタープリターの正しい割り当てから、分離環境(.venv)での依存関係の自動化とインストールまでを網羅します。


予測可能な開発環境を確保するには、ユーザーインターフェースを実行エンジンとプロジェクトごとの依存関係パッケージから分離することが不可欠です。

インタープリタとエディタの違い

Sección titulada «El Intérprete vs. El Editor»
  • Visual Studio Code (UI/エディタ): 高度なテキストエディタおよび統合開発環境として厳密に機能します。組み込みのPythonエンジンは含まず、コード実行を外部のインタープリタに委譲します。
  • Python エンジン (python.exe): コードの命令を処理・解釈する責任を持つバイナリです。システム上、またはサブ環境内で直接実行されます。

グローバル環境 vs. 仮想環境 (.venv)

Sección titulada «Entorno Global vs. Entorno Virtual (.venv)»
  • グローバルPython: システムのベースインストールに相当します。初期テンプレートとして機能し、異なるプロジェクト間の依存関係の衝突を避けるために、外部パッケージを追加してはなりません。
  • 仮想環境 (.venv): 独自の Python バイナリと依存関係ツリー(site-packages)をカプセル化した、分離されたサブディレクトリです。
┌──────────────────────────────────────────────────────────┐
│                   Sistema Operativo                      │
│   (Python Global - Instalación base libre de paquetes)   │
└────────────────────────────┬─────────────────────────────┘
                             │
              ┌──────────────┴──────────────┐
              ▼                             ▼
   ┌────────────────────┐        ┌────────────────────┐
   │    Proyecto A      │        │    Proyecto B      │
   │  (.venv A - Aislado)│        │  (.venv B - Aislado)│
   │  - Pandas v1.0     │        │  - Pandas v2.0     │
   │  - Requests        │        │  - Gemini API      │
   └────────────────────┘        └────────────────────┘

2. ステップバイステップの構成手順

Sección titulada «2. Procedimiento de Configuración Paso a Paso»

ワークスペースが依存関係の失敗なく初期化および実行されるようにするには、以下の順序を厳密に遵守してください。

ステップ1: オフィシャル拡張機能のインストール

Sección titulada «Paso 1: Instalación de la Extensión Oficial»
  1. VS Code の 拡張機能 タブにアクセスします(Ctrl + Shift + X)。
  2. 公式の Python拡張機能を検索してください。これは Microsoft によって開発されました。
  3. クリック インストール。この拡張機能により、エディタでデバッグ機能、IntelliSense、およびダイナミックなインタープリタ管理が可能になります。

ステップ 2: グローバル インタープリターの特定(winget の場合)

Sección titulada «Paso 2: Localización del Intérprete Global (Casos de winget)»

winget や Microsoft Store などのパッケージ マネージャーから Python をインストールした場合、インストーラーが標準的なシステム パス(PATH)に実行ファイルを登録しないことがよくあります。基本となる実行ファイルを特定するには:

  1. システムのコマンド端末(CMDまたはPowerShell)を開きます。
  2. 以下の検索コマンドを実行します:
Ventana de terminal
where.exe python
  1. ターミナルは、現在アクティブな実行ファイルへの絶対パスを返します。例: C:\Program Files\Python312\python.exe または C:\Users\<Usuario>\AppData\Local\Microsoft\WindowsApps\python.exe。このパスを保存してください。

ステップ 3: 仮想環境の初期化(.venv)

Sección titulada «Paso 3: Inicialización del Entorno Virtual (.venv)»

統合されたVS Codeメニューでの失敗やブロッキングダイアログウィンドウを避けるために、エディタのターミナルから直接環境を作成してください:

  1. VS Code の統合ターミナルを開きます(Ctrl + Ñ または Ctrl + ~)。
  2. .venv というディレクトリ名を指定して、標準の仮想環境モジュールを実行します:
Ventana de terminal
python -m venv .venv
  1. 実行が完了すると、ワークスペースのルートに新しいディレクトリ .venv が作成されます。

ステップ4: VS Codeインタープリタと仮想環境のリンク

Sección titulada «Paso 4: Vinculación del Intérprete de VS Code con el Entorno Virtual»

サブディレクトリ .venv を作成しただけでは、エディターでの接続は有効になりません。VS Code に新しく作成したインタープリターを使用させる必要があります:

  1. VS Code エディターで少なくとも .py 拡張子のファイルが 1 つ開かれ、選択されていることを確認してください(これにより、Python のコンテキスト エンジンが有効化されます)。
  2. Ctrl + Shift + P を使用してコマンド パレットを開きます。
  3. Python: Select Interpreter(Python: インタープリターの選択)と入力して選択します。
  4. エディタは一覧を表示します。ローカル環境を直接指すオプションを選択してください。通常、推奨されていると示されています:
Ventana de terminal
Python 3.x.x ('.venv': venv) ./.venv/Scripts/python.exe
  1. 状態の確認: VS Code ステータス バーの右下隅を確認します。
    • ✕ 誤ったパス: Python 3.x.x が表示されます(グローバル システム バイナリを使用しています)。
    • ✓ 正しいパス: Python 3.x.x ('.venv') が表示されます(環境が正しくリンクされています)。

ステップ5: コンソールの有効化と依存関係のインストール

Sección titulada «Paso 5: Activación de la Consola e Instalación de Dependencias»

エディタでインタープリタがリンクされると、新しいターミナルを開くたびに自動的にアクティブな仮想環境を引き継ぎます。

  1. 新しい統合ターミナルを開きます(Ctrl + Ñ)。
  2. コマンドプロンプトが左端にアクティベーション接頭辞を表示していることを確認してください:
Ventana de terminal
(.venv) PS C:\MiProyecto>
  1. 隔離された環境内で必要なプロジェクトライブラリを直接インストールします:
Ventana de terminal
pip install google-generativeai requests pandas

症状根本原因解決策
統合メニュー Create Environment が手動でのパス入力を求めてフリーズします。VS Code は、システムの PATH 内の基本 Python インストールを自動的に検出できません(winget 経由でのインストールでよくあります)。統合ダイアログを取り消します。本ガイドの ステップ 3 に従い、python -m venv .venv を使用してターミナルから手動で環境を作成してください。
‘Play’ を押した際に ModuleNotFoundError: No module named '<libreria>' エラーが発生する。コードは、インストールされたパッケージを含むインタプリタとは異なるインタプリタで実行されています(通常はグローバルなものです)。1. VS Code の右下バーを確認し、サブインタープリター ('.venv') がリンクされていることを確認します。
2. リンクされていない場合は、ステップ 4(Select Interpreter)を繰り返してください。
ターミナルを開いても (.venv) プレフィックスが表示されない。現在のコンソールは、インタプリタを構成した後に更新されていないか、PowerShellで実行ポリシーが制限されています。1. 下部パネルのゴミ箱アイコンですべてのアクティブなターミナルを閉じます。
2. 完全に新しいターミナルを開きます(Ctrl + Ñ)。アクティベーション スクリプトが自動的に実行されます。
VS CodeのステータスバーにPythonバージョンセレクターが表示されません。エディタがPythonのコンテキストサービスを読み込めていないのは、開いているコードファイルがないためです。Microsoft の拡張機能を強制的に初期化するため、メイン エディターで .py 拡張子の任意のファイルを開きます。