CLion 2026.2 Help

Python 拡張機能をデバッグする

Python と C/C++ が混在するコードの相互デバッグは、現在 CLion(CPP-5797(英語) )ではサポートされていません。 ただし、 Python 拡張モジュール(英語)を使用する場合は、以下で説明するオプションの 1 つを使用して、これを回避できます。

拡張機能の C/C++ コードをデバッグするには、ネイティブデバッガー、GDB または LLDB を使用し、スクリプトを読み込んでアプリケーションを実行するインタープリタープロセスをデバッグする必要があります。 そのためには、 実行中の Python プロセスに接続するか、 適切に構成されたカスタムビルドアプリケーションをデバッグすることができます

オプション 1: ネイティブデバッガーを使用して、実行中の Python プロセスにアタッチする

  1. ブレークポイントを設定し、プロセスにアタッチした にブレークポイントがヒットすることを確認します。

  2. Python スクリプトを起動します。 これは、システムターミナル、CLion の 内蔵ターミナルから、 Python の設定を実行することによって実行できます。

  3. メインメニューから 実行 | プロセスにアタッチ を呼び出すか、 Ctrl+Alt+F5 を押してください。

  4. エントリのリストで、 ネイティブノードのプロセスの PID に対応するものを検索します。

    実行中の Python プロセスへの接続
  5. デバッガーが正常に接続されると、通常どおりネイティブコードをデバッグできるようになります。 詳細については、「デバッグ 」セクションを参照してください。

  6. 終了したら、 実行 | 停止 を呼び出すか、ツールバーまたは デバッグツールウィンドウ中断 をクリックして、プロセスから切り離します。

オプション 2: カスタムビルドアプリケーション構成をデバッグする

ネイティブデバッガーをアタッチする代わりに、その下で Python インタープリターを起動できます。 このオプションは、スクリプトを呼び出す正確なインタープリターコマンドがわかっている場合に使用できます。

ネイティブ拡張機能を再ビルドするための カスタムターゲットと、そのカスタムターゲットを呼び出して適切な引数で Python インタープリターを実行する カスタムビルドアプリケーション構成を作成する必要があります。

  1. メインメニューで、 実行 | 実行構成の編集​ に移動し、 をクリックして、 カスタムビルドアプリケーション を選択します。

  2. ターゲット​ フィールドにある カスタムビルドターゲットを設定するをクリックします。 これにより、 設定 | ビルド、実行、デプロイ | カスタムビルドターゲット ダイアログが開きます。

  3. をクリックして新しいターゲットを追加し、ターゲットの名前を設定します。

  4. ツールチェーンを選択します。 CLion は、選択したツールチェーンのデバッガーを使用します。

  5. プロジェクトを構築するためのツールを設定します。 ビルド フィールドの横にある 参照ボタン をクリックしてから、 をクリックして新しいツールを追加します。

    ツールの構成を指定します。 以下のスクリーンショットは、 pip install -e を使用する場合を示しています。

    外部ツールとしての Pip インストール
  6. 編集ツール および カスタムビルドターゲット ダイアログで変更を保存し、実行 / デバッグ構成のセットアップに戻ります。

    カスタムビルドアプリケーション

    次の設定を指定します。

    • 実行可能ファイル - Python インタープリターのパスを指定します。

    • プログラム引数 - 必要に応じて、追加の引数を使用してスクリプト名を指定します。

    • 作業ディレクトリ - プロジェクトルートへのパスを設定します。 ここでは、マクロ( )と パス変数を使用できます。

  7. 構成を保存した後、通常どおり デバッグセッションを開始できます:

    Python 拡張機能のデバッグ
2026 年 7 月 15 日