Eclipseのブレークポイント設定一覧|条件付き・ヒットカウント・トリガーまで解説

このサイトはアフィリエイト広告(Amazonアソシエイト含む)を掲載しています。
Eclipseのブレークポイントで、条件付き・ヒットカウント・トリガーを使い分ける図

Eclipseのブレークポイントでは条件付き停止、ヒットカウント、トリガー・ポイント、スレッド/VM単位の中断などを設定できます。「特定の条件だけ止めたい」なら条件付き、「N回目だけ止めたい」ならヒットカウントを使うのが分かりやすいです。

デバッグ中「ここで止めたい」という場面でとりあえずブレークポイントを置く、という使い方がほとんどではないでしょうか。筆者もずっとそれだけを使っていたのですが、ブレークポイントには実はいろいろと設定項目があります。うまく使えばデバッグ効率がかなり上がりそうなのでまとめてめもしました。

検証環境(確認日:2025年12月)
OS

Windows 11 Home 25H2

IDE

Pleiades All in One Eclipse 2025-09

Eclipse言語設定

日本語

Eclipseまわりの設定やトラブル対処をまとめて確認したい場合はこちらも参考になります。

目次

ブレークポイントの一覧表示と基本操作

ここではJavaの行ブレークポイントを例に説明します。実行可能なコード行の左端をダブルクリックするとブレークポイントを設定できます。デバッグ実行でその行に到達すると行の処理を実行する前に一時停止します。

設置したブレークポイントを一覧で確認するには、「ウィンドウ」→「ビューの表示」→「その他」→「デバッグ」→「ブレークポイント」を開きます。一覧の項目をダブルクリックすると対応するソース位置へ移動できます。

やりたいこと操作
ブレークポイントを追加・削除するソースコード左端のマーカー欄をダブルクリックする
条件などを設定する対象のブレークポイントを右クリックし「ブレークポイントのプロパティ」を開く
選んだブレークポイントを一時的に無効にするブレークポイント・ビューで対象のチェックを外す
全体を一時的にスキップする「すべてのブレークポイントをスキップ」をONにする。再び止めるときはOFFに戻す
不要なブレークポイントを一括削除するブレークポイント・ビューの「すべて削除」を使う

一時的に止めたくないだけなら無効化やスキップを使うと設定を残せます。「すべて削除」は残しておきたいブレークポイントも削除するため、対象を確認してから実行してください。表示名はEclipseのバージョンや日本語化の状態によって異なる場合があります。

用途別:どのブレークポイント設定を使う?

Eclipseのブレークポイントには複数の種類がありますが、実務では「どの設定を使うべきか迷う」ことも多いです。
まずは以下の表で、自分の状況に合う設定を確認してください。

やりたいこと使う設定おすすめ度用途例
特定の条件の時だけ止めたい条件付きブレークポイント★★★★★ID=100の時だけ停止
10回目のループで止めたいヒットカウント★★★★★for文の10周目確認
一度止まったら無効化したいDisable on hit★★★★☆初回だけ確認したい
別の箇所が止まったらここも有効化したいトリガー・ポイント★★★★☆処理A通過後のみ停止
全スレッドを止めたいSuspend VM★★★☆☆マルチスレッド調査

迷った場合は、まず条件付きブレークポイントとヒットカウントを覚えるだけでも、デバッグ効率はかなり上がります。

ブレークポイントの設定項目一覧

ブレークポイント設定とは、単に「コードを停止する場所」を指定するだけでなく「いつ・どの条件で・どこまで停止するか」を制御するための設定です。Eclipseのブレークポイント・ビューで該当ブレークポイントを選択すると、以下の項目が表示されます。

設定項目概要
トリガー・ポイント他のブレークポイントを有効化するスイッチになる。
ヒット時に実行を継続トリガー・ポイント通過時に中断しないようにする。
Disable on hit通過したらそのブレークポイントをOFFにする。
ヒット・カウント指定回数に達したときだけ中断する。
スレッドの中断そのスレッドだけ止めて他のスレッドは動かし続ける。
VMの中断VM内の全スレッドを一斉に止める。
条件付き(’true’の時)条件式がtrueのときだけ中断する。
条件付き(値変更時)条件式の評価結果が前回から変わったときだけ中断する。

各設定の詳しい仕様はEclipse公式ヘルプの「Breakpoint Properties…」でも確認できます。Eclipseのバージョンによって表示項目が異なる場合は、公式情報もあわせて確認してください。

トリガー・ポイント

トリガー・ポイントとは

「このブレークポイントを通過したら、他のブレークポイントを有効化する」というスイッチの役割を持つ設定です。

トリガー・ポイントをONにするとそれ以外のブレークポイントが待機状態になります。デバッグ実行中は待機状態のブレークポイントでは止まりません。トリガー・ポイントを通過した瞬間に待機状態が解除され、それ以降は通常どおりブレークポイントが機能するようになります。

トリガー・ポイントを複数設定した場合はいずれか1つに到達すると待機状態が解除され、その時点ですべてのトリガー設定がOFFになりデバッグ実行の終了後に再び有効になります。これらはあくまでトリガー・ポイントで設定したもので、通常のブレークポイントは関係ありません。

使いどころとしては「最初の初期化処理は飛ばして特定の前提条件が整ったあとからデバッグしたい」というケースに向いています。

ヒット時に実行を継続

トリガー・ポイントはデフォルト設定(スレッドの中断)のままだと、通過時に一度中断します。「スイッチとして使いたいだけで止まりたくない」というときは「ヒット時に実行を継続」をONにしておくと中断せずそのまま処理が続きます。

Disable on hit

ONにすると通過時にそのブレークポイントが自動でOFFになります。トリガー・ポイントと似ていますが処理終了後もONに復帰しない点が異なります。なぜか日本語化されていない

1回だけ止まれば十分なケースや「最初の1回だけ確認したい」という場面で活用できますね。

ヒット・カウント

指定した回数目に到達したときだけ中断します。たとえば10と設定すると10回目の通過時に止まります。カウントは1始まりです(0回目ではなく1回目から数えます)。指定回数に達して中断するとそのブレークポイントは無効になります。同じデバッグ実行中にもう一度使う場合は、再度有効にするか、ヒット・カウントを変更します。

ループ処理のデバッグで「100回ループする処理の50回目だけ確認したい」といった場面で重宝します。

スレッド/VMの中断

ブレークポイント・ビューではヒット・カウントの子項目のように見えますが、実質的には全体的な中断方法の設定です。

スレッドの中断

対象のブレークポイントを実行しているスレッドだけが一時停止し、同じVM内の他のスレッドはそのまま動き続けます。

複数スレッドが動いているアプリで「このスレッドの動きだけ追いたい、でも他のスレッドは止めたくない」というときに有効です。

VMの中断

ブレークポイントに到達した瞬間にVM内の全スレッドが一斉に停止します。

バックグラウンド処理が勝手に状態を書き換えると困る場面や「このタイミングの全体状態をそのまま固めて確認したい」というときに向いています。

条件付きブレークポイント

条件付きブレークポイントは指定した条件を満たしたときだけ止める設定です。Javaの場合は対象のブレークポイントを右クリックし、「ブレークポイントのプロパティ」で条件を有効にして式を入力します。「‘true’の時に中断」か「値変更時に中断」を選び設定を確定してください。

条件式に使えるのはその位置で参照できる変数やフィールドです。ブレークポイント・ビューの詳細欄からも設定できます。

Eclipseのブレークポイントビュー
「条件付き」を有効にし、赤枠の入力欄に条件式を指定します。

‘true’の時に中断

ブレークポイントに到達するたびに条件式を評価し結果がtrueのときだけ中断します。たとえばcount == 50という式を書いておけばループ変数が50になったときだけ止まります。毎回止まる必要がなくなるのでデバッグ効率が一気に上がりますね。

下記は条件式の一例です。変数名は実際のコードに合わせて変更してください。

止めたい条件条件式の例
数値が50になったときcount == 50
文字列がERRORのとき"ERROR".equals(status)
数値が50以上で、文字列がERRORのときcount >= 50 && "ERROR".equals(status)
変数がnullのときvalue == null

値変更時に中断

ブレークポイントに到達したときに式を評価し、前回の評価結果から変化していれば中断します。たとえば数値の変化を調べる場合は条件式にcountを指定します。

変化を確認するのはブレークポイントを置いた行に到達したタイミングです。途中の別の行で値が変わっても、その瞬間に止まるわけではありません。フィールドへの書き込み位置で止めたい場合はウォッチポイントの変更時中断を使います。

条件式に使うJavaコードやコレクション操作を見直したい場合はStream APIの基本も押さえておくとデバッグしやすくなります。

ブレークポイントで止まらないときに確認する設定

ブレークポイントを置いても止まらない場合は、まず起動方法と停止条件を確認します。

確認すること見直す内容
デバッグ実行しているか通常の実行ではなくデバッグで起動します。Tomcatなどのサーバーもデバッグモードで起動します
対象が有効になっているかブレークポイント・ビューで対象のチェックと、「すべてのブレークポイントをスキップ」の状態を確認します
条件を満たしているか条件式、ヒット・カウント、トリガーによる待機状態を確認します
その行が実行されるか分岐や呼び出し条件を確認します。行ブレークポイントは実行可能なコード行に設定します

設定の影響を切り分ける場合は現在の設定を控えたうえで条件を一時的に外し、通常の行ブレークポイントとして止まるか確認すると分かりやすいです。


macOSでEclipse 2025-06自体が固まる場合は実行JDK・Lombok・メモリ・ワークスペースを確認する対処記事も参考になります。

迷いやすいポイント

ヒット・カウントとトリガー・ポイントは同時に使える?

設定上は同じブレークポイントに両方を設定できます。ただし動作が複合するため挙動が把握しにくくなります。それぞれ別のブレークポイントに分けるほうが管理しやすいと思います。

条件式に書けるのはJavaの式?

この記事で扱うJavaの条件付きブレークポイントにはJavaの式を記述します。「‘true’の時に中断」では評価結果がtrueまたはfalseになる式を使います。変数やフィールドはそのブレークポイントの位置で参照できるものを指定してください。

Disable on hitとヒット・カウントの違いは何?

ヒット・カウントは指定したN回目の到達で止まりその後は無効になります。Disable on hitはヒットしたブレークポイントを自動で無効にする設定です。

まとめ

  • トリガー・ポイントは「このポイントを通過してから他を有効化する」スイッチとして使えるよ。
  • ヒット・カウントはループ処理で「N回目だけ止めたい」ときに使うと効率が上がるよ。
  • スレッド中断とVM中断は「他スレッドを動かし続けたいか止めたいか」で使い分けるといいよ。
  • 条件付きブレークポイントは条件式とセットで使って、特定の状態のときだけ止めることができるよ。
  • Disable on hitはトリガー・ポイントと違って処理終了後もOFFのままなので使いどころに注意してね。
  • URLをコピーしました!
目次