VS CodeでPythonデバッグ環境構築 | 2026年最新ガイド

2026年最新のVS CodeによるPythonデバッグ環境構築の概要

本記事では、2026年に予定されているPython 3.13系導入とDebugger for Python拡張機能の利用方法を網羅的に解説します。近年の技術進展に伴い、VS Codeでのデバッグ設定はOSやライブラリバージョンごとに手順が異なるため、注意が必要です。特に、開発環境の安定性向上と最新ツールとの互換性確認が重要になります。この記事では、debugpyとの連携方法やトラブルシューティング対策も詳細に記載しており、Python開発者がスムーズなデバッグを実現するための指針となります。

Pythonインストーラーでの環境構築手順（3.12系以降）

Python 3.12系は、VS Codeとの連携に最適化されたバージョンであり、開発環境の安定性と性能向上を目的とした改良が施されています。ただし、2026年時点での実際のリリース状況に整合性があるかは確認が必要です。以下にインストール手順を記載します。

Windows/Mac/Linux共通のインストール手順

1. 公式サイト（https://www.python.org/downloads/）からPython 3.12系または最新バージョンをダウンロードします。
2. Windowsでは「Windows x86-64 executable installer」、macOSでは「macOS 10.15+ x86_64 / arm64 installer」を選択してください。

3. Linuxユーザーはパッケージマネージャー（APTやyum）でインストール可能ですが、最新版を確認するためには公式サイトからバイナリをダウンロードすることを推奨します。

4. インストーラー実行時に「Add Python to PATH」にチェックし、環境変数の設定を自動化してください。

5. Windowsではコマンドプロンプトでpython --versionを実行し、macOS/Linuxではターミナルでpython3.12 --versionを入力してインストールが成功しているか確認します。

Pythonパスの確認と環境変数設定

環境変数が正しく設定されていないと、VS CodeからPythonスクリプトの実行時にエラーが発生する可能性があります。

OS別のPATH設定手順

VS Code拡張機能「Debugger for Python」のインストール方法

VS CodeでPythonデバッグを実行するには、公式拡張機能「Debugger for Python」の導入が必要です。以下にインストール手順を記載します。

拡張機能市場からの検索と導入手順

1. VS Codeを開き、「Extensions（拡張機能）」アイコンをクリックします。
2. 検索バーに「Debugger for Python」と入力し、Microsoftが提供する公式拡張機能を見つけてください。
3. 「Install（インストール）」ボタンをクリックし、拡張機能をインストールします。

重要：非公式の拡張機能は安全性や互換性に問題があるため、本記事では推奨しません。

バージョン確認と有効化チェック

• 拡張機能が正しくインストールされているかは、「Extensions」タブで確認できます。
• 「Debug: Open launch.json」コマンドを実行して、デバッグ設定ファイルが生成されるかどうかで拡張機能の有効性を判断してください。

launch.jsonのカスタマイズとブレイクポイント設定

launch.jsonはVS CodeでPythonスクリプトをデバッグする際に必要な構成ファイルです。このファイルをカスタマイズすることで、引数の指定や環境変数の定義が可能です。

デバッグ構成ファイルの生成手順

1. VS CodeでPythonスクリプトを開き、「Run and Debug（実行＆デバッグ）」アイコンを選択します。
2. 「create a launch.json file」リンクをクリックし、テンプレートを選択してください。
3. テンプレート選択後、自動的にlaunch.jsonファイルが生成されます。

例:

条件付きブレイクポイントの作成方法

• ブレイクポイントを設定するには、コードの行番号左側にマウスを置き、クリックします。
• 「条件付きブレイクポイント」は右クリック → 「When」から設定可能です。

例: x > 10という条件で実行を停止させたい場合は、「when: x > 10」と入力してください。

OS別デバッグ設定ガイド（Windows/macOS/Linux）

各OSにはターミナルの種類やPythonパスの指定方法に差異があるため、それぞれに対応した設定手順を紹介します。

各OSでの特有な設定手順

ターミナルエミュレータとの連携方法

• Windows: VS Codeの「Integrated Terminal」を使用し、Pythonスクリプトが3.12系で実行されることを確認してください。
• macOS/Linux: which pythonコマンドで利用しているPythonバージョンをチェックし、必要に応じてpython3.12を明示的に使用するように設定します。

debugpyライブラリとの連携手順

debugpyはVS CodeとPythonデバッグ環境をつなぐための重要なライブラリです。最新バージョンで動作するよう、以下のように設定してください。

pipでのインストール方法

1. ターミナルで以下のコマンドを実行してdebugpyをインストールします：
   bash
pip install debugpy

2. pip show debugpyでインストール済みバージョンを確認してください。

launch.jsonでのremote debugging設定

• ローカルデバッグの場合、以下のように設定してください：
  json
{
"name": "Python: Remote Debug",
"type": "python",
"request": "attach",
"connect": {
"host": "localhost",
"port": 5678
}
}

• リモートデバッグ（例：Jupyter Notebook）の場合は、以下のコマンドをスクリプト内に記述し、VS Codeで接続します：
  python
import debugpy
debugpy.listen(("0.0.0.0", 5678))
debugpy.wait_for_client()

よくあるトラブルシューティング

デバッグが開始しない、エラーが出るなどの問題は、以下のように順を追って確認してください。

デバッグが開始しない場合のチェックリスト

1. 拡張機能が有効になっているか確認：「Extensions」タブで「Debugger for Python」がアクティブ化されていることを確認します。
2. launch.jsonファイルの設定が正しいか："program"フィールドのパスが正しく設定されているかをチェックしてください。
3. Pythonインタプリタが3.12系であるか：VS Codeで「Ctrl+Shift+P」→ Python: Select Interpreterから確認します。

バージョン不一致時の解決策

• 拡張機能バージョンとPython実行環境の整合性確認：以下のコマンドでバージョンを出力してください：
  bash
code --version
python3.12 --version
pip show debugpy

• VS Codeログファイルの参照方法：「Help > Toggle Developer Tools」からコンソールを開き、エラーメッセージを確認します。