こんにちは！日々のC++開発、お疲れ様です。
突然ですが、皆さんはコードにバグが潜んでいるを見つけたとき、どのように原因を突き止めていますか？
「あちこちに `std::cout` を埋め込んで変数の値を出力し、コンパイルし直して実行……」
もし、そんな原始的な方法で消耗しているとしたら、今日でそのやり方は終わりにしましょう。
MacでC++を書くなら、Apple製開発環境（Xcode）の裏側で静かに、しかし圧倒的なパワーで君臨している標準デバッガ 「LLDB（Low-Level Debugger）」 が使えます。
GUIのXcode画面をポチポチクリックするのも悪くありませんが、コマンドラインからLLDBを直接叩けるようになると、プログラムの「内部で起きていること」が手に取るように見通せるようになります。コンパイルの待ち時間も、ログ出力のための無駄なコード書き捨ても不要。
これをマスターすれば、毎日のコーディングが劇的に楽になりますよ。
さあ、今日から一緒に、低レイヤの世界を覗き見するデバッグの旅に出かけましょう！
—
1. LLDBとは何か？なぜコマンドラインで使うべきなのか
LLDBは、LLVMプロジェクトの一部として開発されている次世代の高速デバッガです。C、C++、Objective-C、Swiftなど、Appleエコシステムにおけるネイティブ言語のデバッグにおいて圧倒的なシェアと信頼性を誇ります。
多くの開発者は、XcodeやVS Codeの「デバッグパネル（GUI）」という便利なフィルターを通してLLDBを使っています。しかし、その下で何が起きているのかを知らないままでは、複雑なポインタ操作のバグや、メモリリーク、セグメンテーション違反（Segmentation Fault）に直面したときに対応できなくなってしまいます。
コマンドラインから直接LLDBを操作できるようになると：
- 環境に依存しない： 重いIDEを立ち上げなくても、SSH先のサーバーや軽量エディタ（VS Code / Neovimなど）環境ですぐにデバッグできる。
- マシンの内部状態が生々しく見えてくる： レジスタの値、メモリの1バイト単位のデータ、関数のコールスタックがダイレクトに手に入り、コンピュータの挙動に対する理解が一段と深まる。
「難しそう」と感じる必要は全くありません。今日は、一番よく使う基本のキから、優しく丁寧に紐解いていきます。
—
2. 基礎セットアップ：最初の一歩を踏み出そう
まずは、お使いのMacでLLDBがすぐに使える状態かを確認し、デバッグしやすいバイナリ（実行ファイル）の作り方を体に覚え込ませましょう。
動作確認とインストール
MacでXcode Command Line Toolsをインストールしていれば、LLDBはすでにあなたのマシンに標準搭載されています。ターミナルを開いて、以下のコマンドを叩いてみてください。
LLDBのバージョンを確認する
lldb –version
`lldb-1500….` のようなバージョン情報が返ってくれば、準備完了です！
デバッグの絶対原則：`-g` オプション
C++のコードをデバッグする際、最も重要な大前提があります。それは、コンパイラ（`clang++`）に「デバッグ情報をバイナリに含めてくれ」と指示することです。
これがないと、LLDBは「どの行のコードが、メモリ上のどこに対応しているのか」を指し示す地図（シンボル情報）を失ってしまい、ただの暗号解読になってしまいます。
—
3. 「Hello World」で実践！LLDB基本コマンド4天王
百聞は一見に如かず。実際に小さなC++コードを書いて、LLDBの主要な4つのコマンド（ブレークポイント、実行、変数確認、ステップ実行）を体験してみましょう。
ステップ1：実験用コードの作成
適当な作業ディレクトリに `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 << "LLDB Debug Demo Start!" << std::endl;
int target = 5;
int result = calculateSum(target);
std::cout << "Result is: " << result << std::endl;
return 0;
}
ステップ2：デバッグ用コンパイル
先ほどお伝えした通り、`-g` オプションを付与してコンパイルします。
-g オプションをつけてコンパイルし、デバッグ情報を埋め込む
clang++ -g main.cpp -o main_debug
これで、`main_debug` というデバッグ用の実行ファイルが生成されました。
ステップ3：LLDBの起動とブレークポイントの設定
それでは、LLDBを起動してプログラムを読み込ませましょう。
LLDBに実行ファイルを渡して起動
lldb ./main_debug
ターミナルのプロンプトが `(lldb)` に変わりました。ここからがLLDBの独壇場です。
まずは、`calculateSum` 関数の内部（5行目あたり）でプログラムを一時停止させる「ブレークポイント」を設定します。
calculateSum関数に対してブレークポイントを設定する
(lldb) breakpoint set –name calculateSum
または短縮形
(lldb) b calculateSum
画面に `Breakpoint 1: where = main_debug…` と表示されれば、無事に罠（ブレークポイント）が仕掛けられました。
ステップ4：プログラムの実行と変数の監視
それでは、プログラムを動かしてみましょう。
プログラムの実行を開始する
(lldb) run
（または短縮形 `r`）
すると、プログラムは先ほど仕掛けた `calculateSum` 関数の先頭でピタッと一時停止します。コンソールに次のような表示が出ます。
Process 12345 stopped
- thread #1, queue = ‘com.apple.main-thread’, stop reason = breakpoint 1.1
frame #0: 0x0000000100003f5c main_debug`calculateSum(n=5) at main.cpp:5
5 int sum = 0;
おおっ、止まりましたね！引数 `n` が `5` であることも一目でわかります。
ここで、現在のスコープにある変数の値を確認してみましょう。
現在のフレームにあるローカル変数をすべて表示する
(lldb) frame variable
または短縮形
(lldb) fr v
出力結果：
(int) n = 5
(int) sum = 0
(int) i = 0 (※まだ初期化されていないガベージ値の場合もあります)
ステップ5：ステップ実行（コードを進める）
ここから、ループがどのように回っているかを1行ずつ観察（ステップ実行）します。
次の1行を実行する（関数の中には入らない）
(lldb) next
または短縮形
(lldb) n
数回 `n` コマンドを叩いてループを進め、再度 `frame variable` で変数の変化を確認してみてください。
`sum` の値が `1`、`3`、`6`……と、刻一刻と変化していく様子が生々しく確認できるはずです。この瞬間、「あ、意図通りに動いているな」あるいは「おや、ここでバグってるぞ」という確信が持てるようになります。
デバッグが終わったら、プログラムを最後まで流して終了させます。
プログラムの実行を最後まで継続する
(lldb) continue
または短縮形
(lldb) c
最後に `quit`（または `q`）と打てば、LLDBを終了して元のターミナルに戻ることができます。
—
4. さらに踏み込む！実務で役立つ「メモリダンプ」の覗き見
ここまでの基本操作だけでも十分に強力ですが、最後に「低レイヤデバッガ」らしい、少しマニアックで強力な機能をご紹介します。それがメモリの直接覗き見（メモリダンプ）です。
C++でポインタや配列を扱っているとき、「一体このメモリアドレスには何が格納されているんだ？」と迷うことはありませんか？
LLDBの `memory read` コマンドを使えば、RAM上のバイナリデータを直接画面に引きずり出すことができます。
先ほどのコードの `main` 関数あたりにブレークポイントを張り、変数のアドレスを調べてみましょう。
変数 target のメモリ上のアドレス（&target）を調べる
(lldb) expr &target
仮にアドレスが `0x7ffee3b4878c` だとしましょう。このアドレスのメモリを直接覗いてみます。
指定したアドレスから、4バイト分のメモリ内容を16進数で読み取る
(lldb) memory read –format x –size 4 0x7ffee3b4878c
短縮形
(lldb) x/1xw 0x7ffee3b4878c
コンピュータのメモリ上で、自分の書いた変数がどのようにバイト列として並んでいるのかが見えてきます。このレベルの視点を持つと、メモリリークやバッファオーバーランといった難解なバグも、怖くなくなってくるはずです。
—
5. 先輩エンジニアからのアドバイス：コマンドを指に覚え込ませよう
ここまで、LLDBの基本的な使い方と強力な機能をご紹介してきました。
最初は「コマンドを覚えるのが面倒だな」と感じるかもしれませんが、LLDBは頭文字だけの超短縮形が用意されています。
| 操作 | 通常コマンド | 超短縮形（おすすめ） |
| :— | :— | :— |
| プログラム実行 | `run` | `r` |
| ブレークポイント設定 | `breakpoint set` | `b` |
| 次の行へ進む（ステップオーバー） | `next` | `n` |
| 関数内へ入る（ステップイン） | `step` | `s` |
| 変数の確認 | `frame variable` | `fr v` |
| 継続実行 | `continue` | `c` |
毎日のコーディングの中で、エラーにぶつかったら「よし、少しLLDBで中を覗いてみるか」と、まずは `clang++ -g` でコンパイルし、`lldb ./binary` を立ち上げる癖をつけてみてください。
ほんの数日続けるだけで、あなたのデバッグスピードは数倍に跳ね上がり、バグを恐れない強靭なエンジニアへとステップアップできることをお約束します。
それでは、快適なC++ライフを！次回の記事もお楽しみに。