こんにちは、テックリードの私だ。
開発の現場で、未だに `print()` デバッグや `logger.info()` を大量に埋め込んで「よし、これで変数の値を確認するか……って、またサーバー再起動し忘れた！」などと消耗しているエンジニアを見かけるたびに、私は密かに頭を抱えている。
Pythonにおけるデバッグの基本にして最強の武器、それが標準ライブラリの `pdb`（Python DeBugger）、そしてその強力な上位互換である `IPdb` だ。
「初心者向け」というお題ではあるが、単にマニュアル通りのコマンドを並べるつもりはない。プロの現場で開発スピードを極限まで高め、バグを秒速で駆逐するための「本物の使い方」を、アーキテクトの視点から叩き込む。
—
なぜ今、`pdb` なのか？（インフラストラクチャとしての必然）
まず大前提として、`pdb` は pip installすら不要 で、Pythonさえ入っていれば地球上のあらゆる環境で即座に起動する。Dockerコンテナの最小イメージであれ、AWS Lambdaの実行環境であれ、顧客のオンプレミスサーバーのトラブルシューティングであれ、そこには必ず `pdb` がある。
IDEのグラフィカルなデバッガは素晴らしい。だが、リモート環境へのSSH接続時や、CI/CDパイプラインのコンテナ内、あるいは複雑なマルチスレッドの挙動を追う際、最後に頼りになるのはCUIベースの `pdb / IPdb` のみだ。このツールを使いこなせるかどうかは、シニアエンジニアとジュニアエンジニアの境界線のひとつと言っていい。
—
1. 現場で使える！ミニマム・ハンズオン
百聞は一見にしかず。まずはあえて脆弱性（バグ）を仕込んだコードを例に、実際にコードを止めて変数を覗き見るまでのステップを追ってみよう。
デバッグ対象スクリプト：`culprit.py`
割引価格を計算するロジックだが、バグが潜んでいる
def calculate_discount(price, rate):
# ここにブレークポイントを仕掛ける
import pdb
pdb.set_trace() # この行で実行が一時停止する
discounted = price (1 – rate)
return round(discounted, 2)
if __name__ == “__main__”:
# 意図しないデータ型（文字列）が混入している想定
original_price = “10000”
discount_rate = 0.15
final_price = calculate_discount(original_price, discount_rate)
print(f”最終価格: {final_price}”)
これを実行すると、ターミナル上で以下のように処理がピタリと止まる。
$ python culprit.py
> /path/to/culprit.py(6)calculate_discount()
-> discounted = price (1 – rate)
(Pdb)
この `(Pdb)` プロンプトが出現した瞬間、あなたの手元にはその時点の実行コンテキストの全権限が委譲されている。
—
2. 必須4大コマンドとプロのナビゲーション
`pdb` のコマンドは多岐にわたるが、日々の開発で95%使うのは以下の4つだけだ。これを指に覚え込ませてほしい。
1. `p` (print) / `pp` (pretty print): 変数の値を出力する
2. `n` (next): 現在の行を実行し、次の行へ進む（関数には入らない）
3. `s` (step): 現在の行を実行し、関数内部へ入る
4. `c` (continue): デバッグを終了し、次のブレークポイント（またはプログラム終了）まで一気に走らせる
実行セッションのライブログ
先ほどの `(Pdb)` プロンプトから、実際に内部を覗いてみよう。
(Pdb) p price # 変数 price の中身を確認
‘10000’ # 文字列型になっているバグを発見！
(Pdb) p type(price) # 型を確認
(Pdb) n # 次の行へ進もうとするが…
TypeError: can’t multiply sequence by non-int of type ‘float’
> /path/to/culprit.py(6)calculate_discount()
-> discounted = price (1 – rate)
見事に `TypeError` が発生して止まった。`price` が文字列だったため、乗算で落ちたことが一目瞭然だ。
ここで `pdb` の真骨頂、「実行中のコードの書き換え（インプレース評価）」を使ってみる。
(Pdb) !price = int(price) # 実行中に変数をキャストして修復する
(Pdb) n # 再度、次の行の実行を試みる
> /path/to/culprit.py(7)calculate_discount()
-> return round(discounted, 2)
(Pdb) p discounted # 計算結果を確認
8500.0
(Pdb) c # 処理を続行させる
最終価格: 8500.0
プログラムを再起動することなく、その場で変数を書き換えて後続の処理の動作確認まで完了してしまった。これが `print()` デバッグとは比較にならない圧倒的な生産性の源泉である。
—
3. 開発スピードを劇的に高める神ツール：`IPdb` の導入
素の `pdb` も強力だが、シンタックスハイライトがなく、タブ補完も効かないため、大規模なコードベースではいささか目に優しくない。そこで導入すべきなのが `IPdb` (IPython-enabled pdb) だ。
インストール
pip install ipython ipdb
なぜ IPdb が神なのか？
- 構文ハイライト（Syntax Highlighting）: コードが色付きで表示されるため、スコープや変数の視認性が段違い。
- 強力なタブ補完: `p self.repository.ge
` でメソッドや属性を補完できる。 - `IPdb` の自動埋め込み: コード内に `import ipdb; ipdb.set_trace()` と書く以外にも、例外発生時に自動でデバッガーを起動するモードが使えて最高にクール。
—
4. チーム開発で役立つ設定とベストプラクティス構成例
個人で `pdb/ipdb` を使う分には気の向くままにコードに `set_trace()` を書けばよいが、チーム開発や商用環境が絡むプロジェクトでは、「うっかり `import pdb` や `breakpoint()` を書いたままコミットしてしまい、CIや本番環境でプロセスがブロックされる」という事故が必ず起きる。
これを防ぎ、チーム全体の開発体験を統一するためのベストプラクティス設定を公開する。
① 組み込み関数 `breakpoint()` の活用と環境変数制御
Python 3.7以降では、コードを汚さずに標準のデバッガーを呼べる `breakpoint()` が導入された。これを使えば、明示的に `import pdb` を書く必要がない。
さらに、環境変数 `PYTHONBREAKPOINT` を制御することで、チーム全員のデバッグ環境を統一できる。
プロジェクトルートの `.env` または CI設定ファイル
チーム開発におけるデバッガー挙動の制御設定（例: Docker / CI環境）
本番環境では環境変数を無効化して、万が一のブロックを防ぐ
environment:
- PYTHONBREAKPOINT=ipdb.set_trace # デフォルトを強烈に便利な ipdb に指定する
# 無効化する場合は PYTHONBREAKPOINT=0 を指定すると breakpoint() は無視される
② グローバル設定ファイル：`~/.pdbrc` （または `~/.config/pdb/pdbrc`）
`pdb` は起動時にホームディレクトリの `.pdbrc` を読み込む。シニアエンジニアはここに自分好みのエイリアスや初期設定を書き込み、デバッグの速度を限界まで高めている。
以下は、私が実際に全開発環境で共有・適用している `.pdbrc` の実用設定だ。
==============================================================================
PDB Global Configuration (.pdbrc)
アーキテクトが厳選した、指の移動を最小限にするためのエイリアス定義
==============================================================================
エイリアスの設定: よく使う長大なコマンドを1文字〜数文字に凝縮する
l (list): 現在実行中の周辺コードを表示する範囲を広げる
alias ll list .
c (clear): ブレークポイントを全クリアする
alias clc clear
对象的インスペクションのショートカット
変数のメソッドや属性の一覧をキレイに出力する（dir()のラッパー）
alias mri [x for x in dir(%1) if not x.startswith(‘_’)]
スタックトレースを綺麗に出力する
alias bt where
画面クリア
alias cls !import os; os.system(‘cls’ if os.name == ‘nt’ else ‘clear’)
起動時のログ出力設定
print(“— Professional PDB Session Initialized —“)
この設定を配置するだけで、デバッグセッション中に `mri my_object` と叩くだけで、余計な特殊メソッドを除外したカスタムオブジェクトのプロパティ一覧が瞬時に手に入る。
—
テックリードからの総括
デバッグは「バグを見つけて直す作業」ではない。「コードの実行モデルを頭の中に正確に再現し、仮説を検証するエンジニアリングそのもの」である。
`print()` デバッグという過去の遺物を捨て、`pdb / IPdb` のショートカットと環境設定を手にいれた瞬間から、あなたのコードとの対話速度は桁違いに跳ね上がるだろう。さあ、今すぐ手元の開発環境に `ipdb` をインストールし、次のデバッグから世界を変えてみてほしい。