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

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/clion/llms.txt).

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

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

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

> **Tip:**
> 一般的な情報については、 [プロセスに接続](attach-to-process.html)を参照してください。

1. [ブレークポイント](using-breakpoints.html)を設定し、プロセスにアタッチした  後 にブレークポイントがヒットすることを確認します。

2. Python スクリプトを起動します。 これは、システムターミナル、CLion の [内蔵ターミナル](terminal-emulator.html)から、 [Python の設定](run-debug-configuration-python.html)を実行することによって実行できます。

3. メインメニューから   実行 | プロセスにアタッチ   を呼び出すか、 `Ctrl+Alt+F5` (Windows), `⌥ ⇧ F5` (macOS), `⌥ ⇧ F5` (IntelliJ IDEA Classic (macOS)), `⌥ ⇧ F5` (macOS System Shortcuts), `Ctrl+Alt+5` (XWin), `Ctrl+Alt+5` (GNOME), `Ctrl+Alt+5` (KDE), `Ctrl+Alt+F5` (Emacs), `Ctrl+Alt+F5` (Sublime Text), `⌥ ⇧ F5` (Sublime Text (macOS)), `⌥ ⇧ F5` (Xcode), `Ctrl+Alt+P` (Visual Studio), `⌘ ⌥ P` (Visual Studio (macOS)), `Ctrl+Alt+F5` (ReSharper), `⌃ ⌥ F5` (ReSharper (macOS)), `Ctrl+Alt+F5` (QtCreator), `⌥ ⇧ F5` (QtCreator (macOS)), `Ctrl+Alt+F5` (NetBeans), `Ctrl+Alt+F5` (Eclipse), `⌥ ⇧ F5` (Eclipse (macOS)) を押してください。

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

![実行中の Python プロセスへの接続](https://resources.jetbrains.com/help/img/idea/2026.3/cl_python_ext_attach.png)

> **Note:**
> プロセスに対応するエントリーが2つあります。1つはPythonデバッガーでアタッチでき（Pythonスクリプトをステップ実行するため）、もう1つはネイティブデバッガーでアタッチできます。 後者を選択してください。

5. デバッガーが正常に接続されると、通常どおりネイティブコードをデバッグできるようになります。 詳細については、「 [デバッグ](debugging-code.html)」セクションを参照してください。

6. 終了したら、  `実行 | 停止`  を呼び出すか、ツールバーまたは [デバッグツールウィンドウ](debug-tool-window.html) で ![中断](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.suspend.svg) をクリックして、プロセスから切り離します。

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

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

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

1. メインメニューで、   実行 | 実行構成の編集​   に移動し、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックして、   カスタムビルドアプリケーション   を選択します。

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

3. ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックして新しいターゲットを追加し、ターゲットの名前を設定します。

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

5. プロジェクトを構築するためのツールを設定します。   ビルド   フィールドの横にある ![参照ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) をクリックしてから、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックして新しいツールを追加します。

> **Tip:**
> ここでプロジェクトをクリーニングするためのツールを設定することもできます。

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

![外部ツールとしての Pip インストール](https://resources.jetbrains.com/help/img/idea/2026.3/cl_python_ext_pip_tool.png)

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

![カスタムビルドアプリケーション](https://resources.jetbrains.com/help/img/idea/2026.3/cl_python_ext_custom_config.png)

次の設定を指定します。

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

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

* 作業ディレクトリ - プロジェクトルートへのパスを設定します。 ここでは、マクロ（ ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.add_dark.svg)）と [パス変数を使用](absolute-path-variables.html)できます。

7. 構成を保存した後、通常どおり [デバッグセッションを開始](starting-the-debugger-session.html)できます：

![Python 拡張機能のデバッグ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_python_ext_debug.png)

## See also

### ハウツー

[Debugger options](configuring-debugger-options.html) [Stepping through](examining-suspended-program.html) [Debug tool window](debug-tool-window.html) [逆アセンブルされたコードをデバッグする](disassembly-view.html) [プロセスに接続](attach-to-process.html)

