この記事では Windows環境において Python で作成した Webアプリケーションを VSCode上でデバッグする方法について解説しています。
VSCode上で Python をデバッグするには「Python Debugger」拡張機能を使用します。
Python Debugger
「Python Debugger」拡張機能は「Python」拡張機能と一緒に自動的にインストールされます。
スクリプトのデバッグ
Python スクリプトをデバッグ実行するには、スクリプトファイルを VSCode のエディターに表示し、エディターの実行ボタンの横にある下矢印を押して「Pythonデバッガー：Pythonファイルのデバッグ」を選択します。
Webアプリケーションのデバッグ
Webアプリケーションをデバッグする場合はデバッグ構成ファイルを作成します。
デバッグ構成ファイルは launch.json という名前で、プロジェクトフォルダ直下の .vscode フォルダに作成します。
launch.jsonの新規作成
まだデバッグ構成を設定していない場合 launch.json ファイルは存在しません。
VSCodeでデバッグ構成を設定すると、自動的に launch.json ファイルが作成されます。
Django フレームワークを使ったWebアプリケーションのデバッグ構成は、次の手順で設定します。
1. VSCodeでプロジェクトのフォルダを開き「実行とデバッグ」画面を開きます。
2. 表示される「launch.json ファイルを作成します」をクリックします。
3. 画面上部にデバッガーの種類が表示されるので「Python Debugger」を選択します。
4. デバッグ構成の種類が表示されるので「Django」を選択します。
5. Webアプリケーションを開始するファイル「manage.py」のパスを指定します。
6. .vscode フォルダに launch.json ファイルが作成されます。
この設定によって、DjangoアプリケーションをVSCode上で簡単にデバッグできるようになります。
デバッグ構成の追加
launch.json ファイルが既に存在する場合は以下の手順でデバッグ構成を追加します。
1. launch.json ファイルを VSCode のエディターに表示し、画面右下「構成の追加」をクリックします。
2. 画面上部にデバッガーの種類が表示されるので「Python デバッガー」を選択します。
launch.jsonの新規作成 の4.以降を実施し構成を追加します。
デバッグ実行
実行とデバッグのドロップダウンリストにデバッグ構成の名前が表示されるので、デバッグ実行するものを選択します。
「デバッグの開始」ボタン使用してデバッグ実行を開始します。
launch.json
launch.json の構成内容について解説します。
{
"name": "Python デバッガー: Django",
"type": "debugpy",
"request": "launch",
"args": [
"runserver"
],
"django": true,
"autoStartBrowser": false,
"program": "${workspaceFolder}\\manage.py"
}
name
実行とデバッグのドロップダウンリストに表示されるデバッグ構成の名前になります。わかりやすい名前に変更できます。
type
使用するデバッガーの種類。Pythonをデバッグする場合 "debugpy" とします。
request
デバッグを開始するモード。
・launch : program に指定されたファイルをデバッガーで起動します。
・attach : すでに実行中のプロセスにデバッガーを接続します。
args
program に指定されたファイルに渡す引数を指定します。
django
"true" に設定すると Django Web フレームワーク固有のデバッグ機能が有効になります。
autoStartBrowser
Django または Flask アプリをデバッグするときにブラウザを自動的に開きます。
"true"の場合に有効となりデフォルトでは"false"になっています。
program
Pythonプログラムのエントリモジュール（スタートアップファイル）への完全修飾パスを指定します。${workspaceFolder} は VSCodeで利用できる変数の一つで、ワークスペースのルートディレクトリへのパスを示します。