こんにちは！日々のコーディング、お疲れ様です。
CやC++、あるいはRustなどの低レイヤに近い言語を触っていて、こんな壁にぶつかったことはありませんか？
「画面に `Segmentation fault (コアダンプ)` って表示されたけど、一体ソースコードのどこでメモリを壊したんだ……」
「`printf` デバッグでコードを埋め尽くして、後からそれを消す作業にうんざりしている……」
気持ちは痛いほど分かります。私も昔は、画面出力の海に溺れながらバグを探していました。しかし、GDB（GNU Debugger）とVS Codeの力を借りてから、その世界は一変しました。
今回は、黒い画面の向こうで動くGDBを、使い慣れたVS Codeの美しいGUIから完全にコントロールするための『launch.json完全ガイド』をお届けします。これをマスターすれば、あなたのデバッグ体験は劇的に変わり、毎日のコーディングが驚くほど楽になりますよ。
—
デバッガの本質：なぜ「プリントデバッグ」を卒業すべきなのか？
まず、私たちがこれから向き合う「デバッガ」というツールの本質を少しだけお話しさせてください。
多くの初心者は、バグを見つけるためにコードのあちこちに `printf` や `console.log` を仕込みます。しかし、これには大きなデメリットがあります。
1. コードが汚れる（確認が終わったら消す必要がある）
2. ビルドの時間が無駄になる（書き直してコンパイルするたびに数秒〜数分ロスする）
3. 「その瞬間」のメモリの状態を止められない（動的な挙動を追うのが難しい）
デバッガ（GDB）は、OSとCPUの機能を直接借りて、「プログラムの時間を自由にいじる（止める、戻す、変数を書き換える）」ことができる魔法のようなツールです。そして、そのGDBの複雑なコマンド入力を、私たちが普段使っているVS Codeのボタン一つで操作できるようにするのが、今回の主役である連携設定なのです。
—
1. 基礎セットアップ：環境の確認とツールのインストール
まずは、VS CodeからGDBを呼び出せる土台を作ります。今回はLinux（Ubuntu環境など）をベースに解説を進めますが、Mac（LLDB）やWindows（WSL）でも考え方は全く同じです。
GDBとコンパイラのインストール
ターミナルを開き、以下のコマンドを実行してGDBとC++コンパイラ（g++）がインストールされているか確認・導入してください。
Ubuntu / Debian系の場合
sudo apt update
sudo apt install build-essential gdb -y
インストールが完了したら、正しく入っているかバージョンを確かめておきましょう。
gdb –version
期待される出力例: GNU gdb (Ubuntu …) 12.1… のように表示されればOKです
—
2. 「Hello World」で動作確認：デバッグ対象を用意する
次に、デバッグの実験台となるシンプルなC++のコードを用意します。
適当な作業用フォルダ（例：`debug_practice`）をVS Codeで開き、`main.cpp` というファイルを作成してください。
あえて「ちょっとしたバグ（無限ループや変数の意図しない挙動）」を含んだコードにしてみましょう。
include
// 与えられた数までの総和を計算する関数（わざとバグを仕込んでいます）
int calculateSum(int n) {
int sum = 0;
for (int i = 1; i <= n; i++) {
sum += i;
}
return sum;
}
int main() {
std::cout << "デバッグ演習プログラムを開始します。" << std::endl;
int limit = 5;
int total = calculateSum(limit);
std::cout << "1から " << limit << " までの総和は: " << total << " です。" << std::endl;
return "完了"; // コンパイルエラーになるお茶目なバグをここに！（本当は return 0;）
}
あっと、最後の `return "完了";` でわざとコンパイルエラー（型不一致）を起こさせています。まずはこれをコンパイルして、エラーを直すところから……ではなく、今回は「ビルドタスクとデバッガの設定」に集中するため、正しいコードに修正しておきます。
修正版 `main.cpp`
include
int calculateSum(int n) {
int sum = 0;
for (int i = 1; i <= n; i++) {
sum += i;
}
return sum;
}
int main() {
std::cout << "デバッグ演習プログラムを開始します。" << std::endl;
int limit = 5;
int total = calculateSum(limit);
std::cout << "1から " << limit << " までの総和は: " << total << " です。" << std::endl;
return 0; // 正常終了
}
---
3. 魂の設計図：`launch.json` を完璧に構築する
ここからが本記事のハイライトです。VS Codeに「どうやってこのプログラムをビルドし、どのGDBを使ってデバッグするのか」を教え込みます。
設定ファイルの生成手順
1. VS Codeの左メニューから「実行とデバッグ」アイコン（虫と再生ボタンのアイコン）をクリック。
2. 「C++ (GDB/LLDB)」という選択肢があればそれをクリック。もし出ない場合は、「ランおよびデバッグの構成を作成します」をクリックし、環境に「C++ (GDB/LLDB)」を選びます。
3. これにより、ワークスペースの `.vscode` フォルダ内に `launch.json` が生成されます。
生成されたファイルを、以下のプロ仕様のコメント付き設定に丸ごと書き換えてみてください。各設定値が何を意味しているのか、魂を込めて解説を添えています。
`.vscode/launch.json`
{
// VS Codeのデバッグ設定のバージョン仕様
“version”: “0.2.0”,
“configurations”: [
{
// デバッグメニューに表示される名前（日本語でOKです）
“name”: “C++ GDB デバッグ実行”,
// 使用するデバッガの種別。C/C++の場合は “cppdbg” を指定します
“type”: “cppdbg”,
// 起動方式。”launch” は新しくプロセスを起動する、”attach” は既存のプロセスにアタッチする
“request”: “launch”,
// デバッグ対象となる実行ファイルのフルパス。
// ${workspaceFolder} は現在開いているプロジェクトのルートディレクトリを指します
“program”: “${workspaceFolder}/main”,
// プログラムに渡すコマンドライン引数（今回は空）
“args”: [],
// デバッグ開始前にコンソール入力を受け付けるか（通常はfalseでOK）
“stopAtEntry”: false,
// ワークスペースのルートをカレントワーキングディレクトリに設定
“cwd”: “${workspaceFolder}”,
// プログラムが予期せずクラッシュした際などに外部ターミナルを開く設定
“externalConsole”: false,
// 使用するGDBのパス。システムにパスが通っていれば “gdb” で自動検出されます
“miDebuggerPath”: “/usr/bin/gdb”,
// デバッグ開始の直前に、自動的にビルドタスク（後述のtasks.json）を走らせる魔法の連携設定！
// このおかげで「コードを直す -> 手動でコンパイル -> デバッグ起動」の手間が消滅します
“preLaunchTask”: “C/C++: g++ build active file”
}
]
}
ビルドを自動化する `tasks.json` の設定
`preLaunchTask` で指定したビルドタスクを動かすために、同じく `.vscode` フォルダ内に `tasks.json` が必要です。こちらも以下の内容で用意してください。
`.vscode/tasks.json`
{
“version”: “2.0.0”,
“tasks”: [
{
“type”: “shell”,
// デバッグ時に実行されるコンパイルコマンド
// -g オプション（デバッグ情報の付与）が極めて重要です！これがないと変数の値が見えません
“command”: “g++”,
“args”: [
“-g”,
“${file}”,
“-o”,
“${workspaceFolder}/main”
],
“options”: {
“cwd”: “${workspaceFolder}”
},
“problemMatcher”: [
“$gcc”
],
“group”: {
“kind”: “build”,
“isDefault”: true
},
“detail”: “Generated task by Debug Architect.”
}
]
}
—
4. 快適すぎるGUIデバッグ体験の幕開け
さあ、すべての準備が整いました。ここからの体験は、あなたの開発スタイルを根底から変えてくれます。
① ブレークポイントを置く
`main.cpp` の `int total = calculateSum(limit);` の行番号の左側（行数の左側の余白）をマウスでポチッとクリックしてみてください。赤い丸（ブレークポイント）が灯ります。
② デバッグを実行する
キーボードの `F5` キーを押すか、左メニューの「実行とデバッグ」から緑色の再生ボタンを押します。
何が起きるか？
1. 自動的に `tasks.json` が走り、`-g` オプション付きでバックグラウンドでコンパイルが行われます。
2. 瞬間的にGDBが起動し、プログラムが実行されます。
3. 先ほど赤丸を置いた行の直前で、プログラムの実行がピタッと一時停止します。
③ 変数ビューアーとコントロールパネルの活用
画面の左側に注目してください。
- 「変数」ウィンドウ（ローカル・自動）：
現在メモリ上に存在する `limit` 変数の値が `5` であることや、`sum` の状態が手に取るようにリアルタイムで表示されています。わざわざ `printf` で出力する必要なんて、もうどこにもありません。
- 上部に現れるフローティングコントロールバー：
- 続行 (F5): 次のブレークポイントまで一気に実行を進める
- プロシージャ・オーバー (F10): 関数の中に入らずに、次の行へ進める（ステップオーバー）
- ステップ・イン (F11): `calculateSum` などの関数の中に入り込み、1行ずつ挙動を追う
- ステップ・アウト (Shift + F11): 現在の関数を抜け出して呼び出し元に戻る
`F11` を押して `calculateSum` 関数の中に入り、ループの中で `i` と `sum` がどのように加算されていくのかを自分の目で追ってみてください。プログラムの内部構造が手に取るように理解できるはずです。
—
先輩エンジニアからのメッセージ
いかがでしたでしょうか？
最初は `launch.json` や設定ファイルの記述に少し難しさを感じるかもしれませんが、一度この環境を作ってしまえば、今後はどんなC/C++のプロジェクトであっても快適なデバッグ環境を秒速で構築できるようになります。
「エラーが出たらとりあえずデバッガで止めて、メモリと変数を覗き見る」。
このアプローチが当たり前になると、バグに対する恐怖心が嘘のように消え去り、複雑なアルゴリズムの実装すら楽しくなってきます。
あなたの毎日のコーディングが、よりスピーディで、より創造的なものになりますように。
それでは、快適なデバッグライフを！