PyCharm 2026.1 ヘルプ

プロセスに接続

PyCharm は、デバッグモードではなく、オペレーティングシステムまたは PyCharm ターミナルから起動された Python スクリプトを実行しながら、デバッガーを Python ローカルプロセスに接続する方法を提供します。リモートプロセスには接続できないことに注意してください。

Ubuntu の前提条件

Ubuntu およびその他の Linux ディストリビューションでは、初めてプロセスに接続しようとすると、Ptrace: 操作不可エラーメッセージが表示される場合があります。次のいずれかを実行します。

  1. この制限を一時的に無効にするには、次のコマンドを入力します。

    echo 0 | sudo tee /proc/sys/kernel/yama/ptrace_scope
  2. この制限を永続的に無効にするには、編集用に /etc/sysctl.d/10-ptrace.conf ファイルを開き、kernel.yama.ptrace_scope = 1 行を kernel.yama.ptrace_scope = 0 に変更します。

    変更をすぐに適用するには、上記のコマンド echo 0 | sudo tee /proc/sys/kernel/yama/ptrace_scope を入力します。

    または、sudo service procps restart を実行するか、システムを再始動してください。

詳細については、こちら(英語)をご覧ください(英語)

ローカルプロセスにアタッチする

  1. Ctrl+Alt+F5 を押すか、メインメニューから実行 | プロセスにアタッチを選択します。

  2. PyCharm は、実行中のローカルプロセスのリストを表示します。アタッチするプロセスを選択します。

    Select a process to attach

    プロセスが多すぎる場合は、プロセス名または PID の最初の文字を入力してリストを絞り込むことができます。

    プロセスにアタッチリストに特定のプロセスのみを表示したい場合があります。ビルド、実行、デプロイ | Python デバッガー設定ページ Ctrl+Alt+S の対応するフィールドに必要なパターンを追加します。たとえば、この文字列に一致するプロセスのみを接続する場合は、「Scientific」と入力します。

  3. PyCharm で通常行うのと同じ方法でデバッグを続行します ( ブレークポイントの設定ステップスルー、プロセスの一時停止と再開、式の評価など)。

    アタッチしたプロセスがデバッグ情報を提供しない場合、ブレークポイントは利用できず、逆アセンブリビューでステップが実行されます。

プロセスから切り離す

リモートプロセスからデタッチする手順は、ローカルデバッグセッションを停止する手順と同じです。ただし、ローカルセッションとは異なり、デバッガーがデタッチされた後もターゲットプロセスは実行され続けます。

  • デバッグツールウィンドウデバッグツールウィンドウのツールバーにある停止 the Stop button ボタンをクリックします。

  • または、メインツールバーの停止 the Stop button をクリックするか、Ctrl+F2 を押してから、閉じるセッションを選択します。

2026 年 3 月 31 日

関連ページ:

キーボードショートカットを設定する

PyCharm には定義済みのキーマップがいくつか含まれており、頻繁に使用するショートカットをカスタマイズできます。キーマップ構成を表示するには、設定ダイアログを開き、キーマップを選択します。PyCharm は、環境に基づいて事前定義されたキーマップを自動的に提案します。使用している OS と一致することを確認するか、使用している別の IDE またはエディターからのショートカットと一致するもの(Emacs など)を選択してください。キーマップは、対応するキーボードとマウスのショートカットおよび...

デバッガーセッションを開始する

デバッガーセッションの開始は、プログラムを通常モードで実行するのと非常によく似ています。デバッガーはバックグラウンドで接続されているため、デバッガーセッションを開始するために特別な設定を行う必要はありません。PyCharm からプログラムを実行できる場合は、同じ構成を使用してプログラムをデバッグすることもできます。プログラムをデバッグするたびに、デバッガーセッションは実行 / デバッグ構成に基づきます。これにより、アプリケーションを起動するためのパラメーターとアクションを構成できます。たとえば、...

デバッグ

デバッグセッション中に、デバッガーをアタッチしてプログラムを起動します。デバッガーの目的は、プログラムの実行を妨害し、内部で何が起こっているかに関する情報を提供することです。これにより、プログラムのバグを検出して修正するプロセスが容易になります。デバッグが初めての場合は、PyCharm を使用したデバッグチュートリアルを試してください。デバッガーの実装 PyCharm は複数のデバッガー実装をサポートしています。デフォルトの PyCharm デバッガーに加えて、デバッグアダプタープロトコルをベース...

ブレークポイント

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

プログラムのステップスルー

ステップは、プログラムの段階的な実行を制御するプロセスです。PyCharm は、一連のステップアクションを提供します。特定のステップアクションの選択は、次の行に直接移動する必要があるか、中間のメソッド呼び出しもインスペクションする必要があるかなど、戦略によって異なります。ステップボタンは、デバッグツールウィンドウのツールバーにあります。ステップオーバー:現在のコード行をステップオーバーし、ハイライトされた行にメソッド呼び出しが含まれている場合でも、次の行に移動します。メソッドの実装はスキップさ...

中断されたプログラムを調べる

デバッガーセッションが開始されると、デバッグツールウィンドウが表示され、次のいずれかが発生するまでプログラムが正常に実行されます。ブレークポイントがヒットしました、プログラムを手動で一時停止する、その後、プログラムは中断され、現在の状態を調べたり、実行を制御したり、実行時にさまざまなシナリオをテストしたりできます。フレームを調べる:プログラムの状態はフレームで表されます。プログラムが一時停止すると、現在のフレームスタックがデバッグツールウィンドウのフレームタブに表示されます。フレームはアクティ