GoLand 2026.1 Help

ブレークポイント

ブレークポイントは、特定のポイントでプログラムの実行を一時停止する特別なマーカーです。 これにより、プログラムの状態と動作を調べることができます。 ブレークポイントは、たとえば、特定のコード行に到達したときにプログラムを一時停止するなどの単純なものから、 追加の条件をチェックしたり、 ログに書き込んだりするなどのより複雑なロジックを含むものまであります。

ブレークポイントは、一度設定すると、 一時的なブレークポイントを除き、明示的に削除するまでプロジェクト内に残ります。

ブレークポイントの種類

GoLand では、次のタイプのブレークポイントを使用できます:

  • 行ブレークポイント: ブレークポイントが設定されたコード行に到達したらプログラムを中断します。 このタイプのブレークポイントは、実行可能なコード行に設定できます。

  • 例外のブレークポイント: panic() がスローされたときにプログラムを一時停止します。

ブレークポイントを設定する

行ブレークポイントを設定する

  • ブレークポイントを設定するコードの実行可能な行でガターをクリックします。 または、行にキャレットを置き、 Ctrl+F8 を押します。

    行ブレークポイントをデバッグする

例外ブレークポイントを設定する

  1. Ctrl+Shift+F8 を押すか、メインメニューから 実行 | ブレークポイントの表示 を選択します。

  2. ブレークポイント ダイアログで、 エラーブレークポイントに移動 または JavaScript 例外ブレークポイント を選択します。

    例外ブレークポイントを作成する

ブレークポイントの管理

ブレークポイントを除去する

  • 例外以外のブレークポイントの場合: ガターのブレークポイントをクリックします。

  • すべてのブレークポイントの場合: メインメニューの 実行 | ブレークポイントの表示 Ctrl+Shift+F8 に移動し、ブレークポイントを選択して、 削除 をクリックするか、 Delete を押します。

誤ってブレークポイントを削除してそのパラメーターを失うのを防ぐために、エディターにドラッグするか、マウスの中央ボタンをクリックして、ブレークポイントを削除することを選択できます。 これを行うには、 設定 | ビルド、実行、デプロイ | デバッガー に移動して エディターにドラッグするか、マウスの中ボタンでクリックする を選択します。 ブレークポイントをクリックすると、それが 有効または無効になります。

ブレークポイントのミュート

ブレークポイントでしばらく停止する必要がない場合は、 ミュートできます。 これにより、デバッガーセッションを移動することなく、通常のプログラム操作を再開できます。 その後、ブレークポイントのミュートを解除して、デバッグを続行できます。

  • デバッグ ツールウィンドウのツールバーの ブレークポイントのミュート ボタン ブレークポイントをミュートするボタン をクリックします。

ブレークポイントを使用可能 / 使用不可にする

ブレークポイントを削除すると、その 内部構成は失われます。 パラメーターを失うことなく個々のブレークポイントを一時的にオフにするには、 無効にすることができます。

  • 例外以外のブレークポイントの場合: 右クリックし、必要に応じて 有効化 オプションを設定します。 または、 Alt キーを押しながらブレークポイントをクリックするか、マウスの中ボタンをクリックすることでも設定できます。 マウスの中ボタンにブレークポイントの削除が 割り当てられていないことを確認してください。

  • すべてのブレークポイントの場合: 実行 | ブレークポイントの表示 Ctrl+Shift+F8 をクリックして、リストのブレークポイントをオン / オフにします。

ブレークポイントの移動 / コピー

  • ブレークポイントを移動するには、それを別の行にドラッグします。

  • ブレークポイントをコピーするには、 Ctrl を押したまま、ブレークポイントを別の行にドラッグします。 これにより、宛先に同じパラメーターを持つブレークポイントが作成されます。

設定されたすべてのブレークポイントを表示

Bookmarks ツールウィンドウですべてのブレークポイントのリストを表示できます。 ブレークポイントは、コード内に配置すると、ツールウィンドウの専用リストに自動的に追加されます。

  • メインメニューで、 View | Tool Windows | ブックマーク に移動するか、 Alt+2 を押して ブレークポイント リストを展開します。

ブックマークツールウィンドウ

ブレークポイントのグループ化

たとえば、特定の問題用にブレークポイントをマークする場合、ブレークポイントをグループ分けできます。

  • ブレークポイント ダイアログ Ctrl+Shift+F8 で、グループに配置するブレークポイントを選択し、メニューから グループに移動 を選択します。

ブレークポイントのプロパティを構成する

ブレークポイントのタイプに応じて、特定のニーズに合わせて操作を調整できる追加のプロパティを構成できます。 最も使用されるオプションは、 インテンションを介して利用できます。

  • ブレークポイントインテンションにアクセスするには、ブレークポイントのある行にキャレットを置き、 Alt+Enter を押します。 このオプションは、基本的なブレークポイントプロパティをすばやく設定する必要がある場合に使用します。

  • プロパティの完全なリストにアクセスするには、ブレークポイントを右クリックして 詳細 をクリックするか、 Ctrl+Shift+F8 を押します。

インテンションリファレンス

インテンション

説明

ブレークポイントの除去

選択した行のブレークポイントを 削除します。

ブレークポイントの無効化

選択した行のブレークポイントを 無効にします。

ブレークポイントの編集

最もよく使用されるブレークポイント プロパティを含むダイアログを開きます。 その他のプロパティについては、 詳細 をクリックするか Ctrl+Shift+F8 を押します。

ブレークポイントのプロパティリファレンス

この章では、ブレークポイントで利用可能な機能について説明します。

有効化

プロジェクトから削除せずに一時的にブレークポイントを無効にするには、チェックボックスをオフにします。 無効化されたブレークポイントは、 ステップ実行中にスキップされます。

GoLand を構成することで、ブレークポイントを完全に削除するのではなく、クリックで有効化/無効化できるように設定できます。 これを行うには、 設定 | ビルド、実行、デプロイ | デバッガー に移動し、 ブレークポイントの除去 オプションを エディターにドラッグまたはマウスの中央ボタンをクリック に設定します。

中断

ブレークポイントにヒットした際にプログラムの実行を一時停止するかどうかを指定します。

非中断ブレークポイントは、プログラムを一時停止せずに何らかの式をログに記録する必要がある場合 (たとえば、メソッドが何回呼び出されたかを知る必要がある場合)、またはヒット時に 依存するブレークポイントを有効にする トリガーブレークポイントを作成する必要がある場合に役立ちます。

条件

このオプションは、ブレークポイントがヒットするたびにチェックされる条件を指定するために使用されます。 条件が true と評価された場合、選択されたアクションが実行されます。 それ以外の場合、ブレークポイントは無視されます。

式の結果は、return ステートメントから取得されます。 return ステートメントがない場合、結果はコードの最後の行から取得されます。

式を評価する際は、その副作用によってプログラムの動作や結果に影響が及ぶ可能性があることに注意してください。

ログオプション

ブレークポイントに到達すると、次の内容がコンソールに記録されます:

  • "Breakpoint hit" メッセージ: ブレークポイントに達しました のようなログメッセージ。

  • スタックトレース: 現在のフレームのスタックトレース。 これは、プログラムの実行を中断することなく、このポイントに至ったパスを確認する場合に役立ちます。

  • 評価して記録: "初期化中"len(users) などの任意の式の結果。

    評価とログの設定

    式の結果は、return ステートメントから取得されます。 return ステートメントがない場合、結果は最後のコード行から取得されます。これは式である必要はなく、リテラルでもかまいません。 これを利用してカスタムメッセージを生成したり、プログラム実行中の値をトラックできます。

    式を評価する際は、その副作用によってプログラムの動作や結果に影響が及ぶ可能性があることに注意してください。

ログブレークポイントを設定する

  1. (オプション) ログに記録する式がエディター内の目の前にある場合は、それを選択します。

  2. Shift を押したままガターをクリックします。

一度ヒットしたら除去する

ブレークポイントがヒットされた後、プロジェクトから削除するかどうかを指定します。

次のブレークポイントに到達するまで無効化

次のブレークポイントに到達するまで無効化 ボックスでブレークポイントを選択すると、現在のブレークポイントのトリガーとして機能します。 これにより、指定したブレークポイントに到達するまで現在のブレークポイントが 無効になります。

この操作の後、再度無効化するか、有効化のままにするかを選択できます。

このオプションは、特定の条件下または特定のアクションの後でのみプログラムを中断する必要がある場合に役立ちます。 この場合、通常、トリガーブレークポイントはプログラムの実行を停止するために必要ではなく、 non-suspending になります。

ブレークポイントのステータス

ブレークポイントには、次のステータスがあります:

ステータス

説明

無効

ブレークポイントでプログラムを一時停止することが技術的に不可能な場合、デバッガーはそれを 無効としてマークします。 これは、その行に実行可能なコードがないためよく発生します。

ミュート

すべてのブレークポイントは ミュートされているため、一時的に非アクティブです。

無効

それはされているため、このブレークポイントが一時的にアクティブで 無効

中断しない

このブレークポイントには 中断ポリシーが設定されているため、ヒットしたときに実行が中断されることはありません。

ブレークポイントアイコン

タイプステータスに応じて、ブレークポイントは次のアイコンでマークされます。

例外

標準

行ブレークポイント

例外のブレークポイント

無効

無効な行ブレークポイント

無効な例外ブレークポイント

ミュート

ミュートされた行ブレークポイント

ミュート無効

ミュートされた無効な行ブレークポイント

中断しない

非一時停止行ブレークポイント

無効

無効なブレークポイント

生産性のヒント

デバッグ出力用のブレークポイントを活用する

ノンサスペンド ロギング ブレークポイント(他のデバッガーではウォッチポイントとも呼ばれます)を使い、コードに print ステートメントを挿入する代わりに利用してください。 これにより、デバッグログメッセージをより柔軟かつ一元的に処理することができます。

ログ用ブレークポイントを素早く設定する

非停止 ログブレークポイントを設定するには、 Shift を押しながらガターをクリックします。 これによりプログラムの実行は一時停止せず、 ブレークポイントに達しました のようなメッセージがログに記録されます。 エディターで式をログに記録したい場合は、 Shift を押しながらガターをクリックする前に、その式を選択してください。

ブレークポイントの説明を追加

プロジェクト内にブレークポイントが多数ある場合、検索しやすいようブレークポイントに説明を追加できます。 これを行うには、 ブレークポイント ダイアログ Ctrl+Shift+F8 でブレークポイントを右クリックし、メニューから 説明の編集 を選択します。 ブレークポイント名を入力し始めると、その項目にフォーカスが移ります。

2026 年 5 月 22 日