GoLand 2020.2ヘルプ

ブレークポイント

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

設定したブレークポイントは、一時的なブレークポイントを除いて、明示的に削除するまでプロジェクトに残ります)。

ブレークポイントの種類

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

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

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

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

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

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

    Debug a line breakpoint

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

  1. デバッグツールウィンドウの左側のブレークポイントの表示 View Breakpoints button をクリックするか、Ctrl+Shift+F8を押します。

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

    Create an exception breakpoint

ブレークポイントの管理

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

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

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

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

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

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

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

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

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

  • 非例外ブレークポイントの場合:右クリックして、必要に応じて有効オプションを設定します。ブレークポイントの削除が割り当てられていない場合は、マウスの中央ボタンで切り替えることもできます。

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

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

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

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

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

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

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

  • プロパティの完全なリストにアクセスするには、ブレークポイントを右クリックしてさらにをクリックするか、Ctrl+Shift+F8を押します。このオプションは、すべてのブレークポイントの鳥瞰図とその構成の完全な制御に使用します。

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

インテンション説明
ブレークポイントの除去除去選択した行のブレークポイント。
ブレークポイントを使用不可にする使用不可選択した行のブレークポイント。
ブレークポイントの編集最もよく使用されるブレークポイントプロパティを含むダイアログを開きます。その他のプロパティについては、さらにをクリックするか Ctrl+Shift+F8を押します。

ブレークポイントのプロパティ

使用可能

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

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

中断

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

非一時停止ブレークポイントは、プログラムを一時停止せずに式をログに記録する必要がある場合(たとえば、メソッドが呼び出された回数を知る必要がある場合)や、ヒットしたときに依存ブレークポイントを有効にするマスターブレークポイントを作成する必要がある場合に便利です。

条件

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

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

式を評価するときは、プログラムの動作や結果に影響を与える可能性があるため、可能性のある副作用に注意してください。

ログ・オプション

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

  • "ブレークポイントヒット"メッセージ : Breakpoint reachedのようなログメッセージ

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

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

    The Evaluate and log setting

    式の結果は、returnステートメントから取得されます。returnステートメントがない場合、結果は式でなくてもよいコードの最後の行から取得されます。リテラルも機能します。これを使用して、カスタムメッセージを生成したり、プログラムの実行中にいくつかの値を追跡したりできます。

    式を評価するときは、プログラムの動作や結果に影響を与える可能性があるため、可能性のある副作用に注意してください。

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

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

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

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

これが発生した後に再び無効にするか、有効のままにするかを選択することもできます。

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

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

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

状況説明
無効ブレークポイントでプログラムを一時停止することが技術的に不可能である場合、デバッガーはプログラムを無効としてマークします。この最も一般的な原因は、行に実行可能コードがないことです。
ミュートすべてのブレークポイントはミュートされているため、一時的に非アクティブです。
使用不可それはされているため、このブレークポイントが一時的にアクティブで無効
中断しないこのブレークポイントには中断ポリシーが設定されているため、ヒットしたときに実行が中断されることはありません。

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

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

例外
標準line breakpointexception breakpoint
使用不可disabled line breakpointdisabled exception breakpoint
ミュートmuted line breakpoint
ミュート無効muted disabled line breakpoint
中断しないnon-suspending line breakpoint
無効invalid breakpoint

生産性のヒント

デバッグ印刷にブレークポイントを使用する
コードに印刷ステートメントを挿入する代わりに、non-suspending ログブレークポイント(他のデバッガーではウォッチポイントと呼ばれることもあります)を使用します。これにより、デバッグログメッセージを処理する、より柔軟で集中化された方法が提供されます。
ロギングブレークポイントをより迅速に設定する
non-suspending ロギングブレークポイントを設定するには、Shift を押しながらガターをクリックします。これはプログラムの実行を中断せず、代わりに Breakpoint reachedのようなメッセージを記録します。エディターの前にある式をログに記録する場合は、Shift を押しながらガターをクリックする前に、式を選択します。
ブレークポイントの説明を追加する
プロジェクトに多数のブレークポイントがある場合、検索を容易にするためにブレークポイントに説明を追加できます。これを行うには、ブレークポイントダイアログ Ctrl+Shift+F8 のブレークポイントを右クリックし、メニューから説明の編集を選択します。これで、ブレークポイント名の入力を開始すると、フォーカスが取得されます。
ブレークポイントのグループ化
たとえば、特定の問題のブレークポイントをマークアウトする必要がある場合、ブレークポイントをグループに編成できます。これを行うには、ブレークポイントダイアログ Ctrl+Shift+F8で、グループに配置するブレークポイントを選択し、メニューからグループへ移動を選択します。
最終更新日: 2020年8月19日