パラメータ | 説明 |
---|---|
version | 常に "0.2.0" を指定 |
configurations | 各デバッグ構成 |
compounds | 複数の configurations をまとめて起動するための定義 バックエンドとフロントエンド同時等 |
必須プロパティ
パラメータ | 説明 | 例 |
---|---|---|
type | 使用するデバッガーの種類 | node debugpy cppvsdbg pwa-chrome : Chromium ベースのブラウザ(Chrome / Edge)を制御 |
request | デバッグの起動モード | "launch"(起動)または "attach"(既存プロセスにアタッチ) |
name | ドロップダウンに表示される構成名 | 任意 |
オプションプロパティ
パラメータ | 説明 | 例 |
---|---|---|
presentation | UI 上の並び順や非表示を制御 | |
preLaunchTask / postDebugTask | tasks.json のタスクを前後に自動実行 | |
internalConsoleOptions | Debug Console の開閉動作を制御(例:neverOpen) | |
serverReadyAction | プログラムが特定メッセージを出力したら自動でブラウザを開く |
汎用プロパティ(多数のデバッガーで共通)
パラメータ | 説明 | 例 |
---|---|---|
program | 起動/デバッグ対象のファイルまたは実行可能ファイル | |
args | プログラムに渡すコマンドライン引数(文字列配列) | |
cwd | ワーキングディレクトリ | |
env / envFile | 環境変数オブジェクトまたは .env ファイルへのパス | |
console | internalConsole / integratedTerminal / externalTerminal を指定 | |
stopOnEntry / stopAtEntry | 起動直後に自動でブレーク | |
port | "attach" モード時のデバッグポート | |
localRoot / remoteRoot | リモートデバッグ時のパスマッピング | |
sourceMaps | sourcemap を有効化して元ソースにブレーク可能に 主に JavaScript/TypeScript/Node.js 用) |
"sourceMaps": true |
outFiles | 同上 | |
skipFiles | 同上 | [ "<node_internals>/**" ]・・・nodejsのコードを除外 |
smartStep | 同上 | |
trace | 同上 |
デバッガー固有の主な追加プロパティ例
Node.js (type: "node")
パラメータ | 説明 | 例 |
---|---|---|
runtimeExecutable / runtimeArgs | node 実行ファイルや起動引数を指定 | |
runtimeVersion | nvm/nvs 使用時に Node.js バージョンを切り替え | |
outFiles | ||
resolveSourceMapLocations | ||
timeout | outputCapture |
Python (type: "debugpy")
パラメータ | 説明 | 例 |
---|---|---|
module | -m モード で起動するモジュール名 | |
python | デバッガー用の Python インタプリタパス | |
purpose | ["debug-test"](テストデバッグ時に自動選択) | |
connect | { "host": "...", "port": ... } でリモートアタッチ | |
justMyCode | 標準ライブラリをステップオーバーするか制御 |
C/C++ (type: "cppvsdbg" または "cppdbg")
パラメータ | 説明 | 例 |
---|---|---|
MIMode / miDebuggerPath | GDB / LLDB の指定 | |
setupCommands | デバッガー開始時のコマンド列 | |
externalConsole | 外部コンソール利用の有無 | |
environment | 環境変数リスト | |
stopAtEntry | main 関数で停止 |
ブラウザ (type: "pwa-chrome" / "pwa-msedge")
パラメータ | 説明 | 例 |
---|---|---|
url | デバッグ対象の URL(SvelteKit dev server) | http://localhost:5173" |
webRoot | プロジェクトルートパス | |
userDataDir | カスタムユーザーデータディレクトリ | |
sourcemap の読み込みを有効化。これがないとビルド後のバンドルコードにしかブレークポイントを貼れません。 |
設定例
SvelteKitの設定
{
// IntelliSense を使用して利用可能な属性を学べます。
// 既存の属性の説明をホバーして表示します。
// 詳細情報は次を確認してください: https://go.microsoft.com/fwlink/?linkid=830387
"version": "0.2.0",
"configurations": [
{
"type": "pwa-chrome",
"request": "launch",
"name": "SvelteKit: Chromeプログラムの起動",
"skipFiles": ["<node_internals>/**"],
"url": "http://localhost:5173",
"webRoot": "${workspaceFolder}/src",
"sourceMaps": true,
"resolveSourceMapLocations": [
"${workspaceFolder}/**",
"!**/node_modules/**"
]
}
]
}