CLion 2026.2 Help

デバッグサーバー

デバッグサーバー は、組み込み開発のデバッグ設定を簡単に行うための構成オプションです。 事前構成済みデバッグサーバーを使用すると、実行/デバッグ構成や CMake や Makefile などのビルドシステムターゲットを実行できます。 また、GDB ターゲット拡張リモートモードとして知られる長時間実行されるデバッグサーバーセッションも実行できます。これは、デバッグを停止してもサーバーが終了しません。

このガイドでは、デバッグサーバーを構成してデバッグセッションを実行する方法について説明します。 機能のデモを行うために、SEGGER J-Link デバッガーが組み込まれた nRF52840 開発キット(英語)と、コンソールに「Hello world」を出力する簡単なアプリケーション例を使用します。

デバッグサーバーの設定

  1. 設定 | 詳細設定 | デバッガー に移動し、 デバッグサーバー有効化 チェックボックスを選択します:

    デバッグサーバーの有効化
  2. 設定 | デバッガーデバッグサーバー オプションを見つけるか、メインツールバースイッチャーで ネイティブ | デバッグサーバーの編集 を選択します:

    デバッグサーバーの編集
  3. 新しいデバッグサーバーを追加するには、 + をクリックします:

    新しいデバッグサーバーの追加
  4. 必要なテンプレートを選択してください:

    デバッグサーバーの種類の選択

    汎用 テンプレートはあらゆるデバッグプローブに適しており、より幅広いオプションを提供します。 他のテンプレートはよりシンプルで柔軟性が低く、必要なオプションのみを提供します。 例: SEGGER J-Link テンプレートは J-Link デバッグプローブ専用に設計されており、 ST-LINKESP-IDF はそれぞれ STM32CubeMX および ESP-IDF プロジェクト用に設計されています。

  5. プロジェクトの必要に応じて、適切なタブで GDB サーバー、デバイス、デバッガーを構成します。

    注意すべき重要な設定:

    • GDB サーバー タブにはデフォルト設定がないため、すべてのフィールドを手動で指定する必要があります。

      汎用デバッグサーバーの構成
    • GDB サーバー タブの ヘルプ フィールドでは、 --ヘルプ コマンドラインパラメーターを使用して GDB サーバーを実行し、このフィールドで直接出力を表示し、使用可能な引数を見つけることができます。 青色でハイライトされた引数をクリックすると、自動的に 引数 フィールドに追加されます。 このオプションは、 --ヘルプ パラメーターをサポートする GDB サーバーでのみ機能することに注意してください。

    • 引数 フィールドの横にある テスト実行… をクリックして、引数の有効性を確認することもできます。

    • デバイス設定 タブでは、コンソールポートのみを指定できます。 つまり、コンソールの種類に制限はなく、任意の種類を使用できます。 コンソールを構成するには、 GDB サーバー タブの 引数 フィールドを使用します。

    • デバッガー​ タブでは、 永続セッション 機能に複数の構成オプションがあります。 引数 フィールドで、TCP ホストやポート、その他コマンドライン引数を指定できます。 デバッグ開始時に実行するカスタム接続スクリプトも作成できます。

      一般的な永続セッション
  6. デバッグサーバーの設定が完了したら、 OK をクリックします。 デバッグサーバーがメインツールバースイッチャーに表示されます。 デバッグを開始できます。

実行 / デバッグ構成のインポート

CLion で GDB サーバー実行構成をすでに使用している場合は、それをインポートして汎用デバッグサーバーに変換できます。 IDE がこのような構成を検出すると、対応するアイコンがダイアログに表示されます。

インポート設定アイコン

アイコンをクリックし、必要な構成を選択して、 インポート をクリックします。

設定のインポートボタン

    VCS を使用したデバッグサーバーの共有

    Git のようなバージョン管理システムを使用してデバッグサーバーの構成を共有できます。 デバッグサーバーの XML ファイルは、プロジェクトの .idea/debugServer にあります。

    デバッグサーバーの共有

      デバッグサーバーを使用したデバッグ

      1. ソースコードにブレークポイントを設定します。

      2. メインツールバーのスイッチャーから 実行 / デバッグ構成 を選択します:

        実行 / デバッグ構成の選択
      3. ツールバーの をクリックしてデバッグセッションを開始します。 デバッガーはデバッグプローブに接続します:

        実行 / デバッグ構成の選択

      その後、利用可能なデバッガーアクションを実行し、必要なデータを分析できます。 デバッガーツールウィンドウの機能の詳細については、 概要を参照してください。

      デバッグ ツールウィンドウには、組み込みシステムのデバッグ用に特別に設計されたオプションがいくつかあります。 例: MCU をリセットできます。

      デバイスのリセット

      デバッグサーバーのログまたはコンソール出力を表示するには、 デバッグ ツールウィンドウの サービスを表示 アイコンまたは左側の サービス ツールウィンドウアイコンをクリックします。

      サービスへの切り替え

      GdbServer タブを選択します。

      GDB サーバーログの表示

      コンソール出力を表示するには、 MCU コンソール タブを選択します。

      コンソール出力の表示

      さらに便利にするために、 サービス ツールウィンドウを右に移動してデバッガーを操作し、同時にコンソール出力などを表示することもできます。

      サービスタブの移動
      2026 年 7 月 15 日