Eclipseのブレークポイントでは条件付き停止、ヒットカウント、トリガー・ポイント、スレッド/VM単位の中断などを設定できます。「特定の条件だけ止めたい」なら条件付き、「N回目だけ止めたい」ならヒットカウントを使うのが分かりやすいです。
デバッグ中「ここで止めたい」という場面でとりあえずブレークポイントを置く、という使い方がほとんどではないでしょうか。筆者もずっとそれだけを使っていたのですが、ブレークポイントには実はいろいろと設定項目があります。うまく使えばデバッグ効率がかなり上がりそうなのでまとめてめもしました。
- 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’の時に中断」か「値変更時に中断」を選び設定を確定してください。
条件式に使えるのはその位置で参照できる変数やフィールドです。ブレークポイント・ビューの詳細欄からも設定できます。

‘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・メモリ・ワークスペースを確認する対処記事も参考になります。

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


