PyCharm 2020.3 ヘルプ

デバッグ

デバッグセッション中に、デバッガーをアタッチしてプログラムを起動します。デバッガーの目的は、プログラムの実行を妨害し、内部で何が起こっているかに関する情報を提供することです。これにより、プログラムのバグを検出して修正するプロセスが容易になります。

デバッグオプションを構成する

  1. 設定 / 環境設定 | ビルド、実行、デプロイ | デバッガーで一般的なデバッグプロパティと動作を構成します。

    デバッグが初めての場合は、すぐに使用できる構成が機能します。各デバッガー機能に関するトピックは、参照を提供し、該当する場合は関連する設定を説明します。上級ユーザーで、特定のプロパティを探している場合は、デバッガーリファレンスセクションを参照してください。

  2. ビルド、実行、デプロイセクションで、Python デバッガーを選択し、Python デバッガーオプションを構成します。

  3. プロジェクト | Python インタープリターセクションで、一部のデバッグ構成に必要になる可能性がある Python パッケージを構成します。

  4. カスタム構成を使用する場合は、実行 / デバッグ構成を定義します。これは、いくつかの引数をプログラムに渡す必要がある場合、または起動前に実行する特別なアクティビティが必要な場合に必要です。実行 / デバッグ構成のセットアップ方法の詳細については、実行 / デバッグ構成を操作するセクションを参照してください。ほとんどの場合、引数を必要としない、または特別な要件がない単純なプログラムをデバッグするためにこれは必要ありません。

一般的なデバッグ手順

アプリケーションをデバッグするための万能の手順はありません。実際の要件に応じて、異なるアクションを異なる順序で使用する必要があります。このトピックでは、一般的なデバッグ手順を表す一般的なガイドラインを提供します。特定の機能をいつどのように使用するかの詳細については、それぞれのトピックで説明します。

  1. プログラムを停止する必要がある場所を定義します。これは、ブレークポイントを使用して行われます。ブレークポイントは特別なマーカーであり、デバッガーがプログラムの状態にステップインしてフリーズする必要がある場所や条件を表します。デバッガーによってフリーズされたプログラムは、suspended と呼ばれます。

    ブレークポイントを使用する代わりに、任意の時点でプログラムを手動で一時停止することもできますが、この方法ではデバッガーの機能にいくつかの制限が課せられ、プログラムを一時停止するタイミングに関する精度が高くなりません。

  2. プログラムをデバッグモードで実行します

    エディターの任意の行を右クリックして、コンテキストメニューから <ファイル名> をデバッグしますコマンドを選択するだけです。

  3. プログラムが中断された後、デバッガーを使用して、プログラムの状態および実行中のプログラムの状態に関する情報を取得します

    デバッガーは、変数値、スレッドの現在の状態、現在ヒープにあるオブジェクトの内訳などに関する情報を提供します。また、例外をスローする(たとえば、処理方法を確認する)か、プログラム実行の途中で任意のコードを実行することにより、さまざまな条件でプログラムをテストできます。

    これらのツールを使用すると、特定の時点でのプログラムの状態を調べることができますが、ステップ機能を使用すると、プログラムの段階的な実行を制御できます。ツールを組み合わせることで、バグの原因を推測し、プログラムの堅牢性をテストできます。

関連ページ:

デバッガー

このページを使用して、デバッガーの動作を設定し、そのビューをカスタマイズします。共通オプション:ブレークポイントでデバッグウィンドウを表示するこのチェックボックスが選択されている場合、PyCharm はブレークポイントに到達するとデバッグツールウィンドウをアクティブにします。ブレークポイントでアプリケーションにフォーカスするこのチェックボックスが選択されている場合、ブレークポイントを押すと、PyCharm はエディターにこのブレークポイントの位置を表示し、そのフレームを前面に表示しようとします...

パッケージのインストール、アンインストール、アップグレード

PyCharm は、特定の Python インタープリターの Python パッケージをインストール、アンインストール、アップグレードする方法を提供します。デフォルトでは、PyCharm は pip を使用してプロジェクトパッケージを管理します。Conda 環境では、conda パッケージマネージャーを使用できます。Python インタープリターの Python パッケージを管理するには、プロジェクト設定 / 環境設定で Python インタープリターページを選択するか、ステータスバーの Pytho...

ブレークポイント

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

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

デバッガーセッションの開始は、通常モードでのプログラムと非常に似ています。デバッガーはバックグラウンドで接続されているため、デバッガーセッションを開始するために特別な設定を行う必要はありません。PyCharm からプログラムを実行できる場合は、同じ構成を使用してプログラムをデバッグすることもできます。このトピックは、実行 / デバッグ構成の理解に依存しています。PyCharm は追加のセットアップなしで単純なアプリケーションをデバッグする方法を提供しますが、デバッガーを効率的に使用するには実行...

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

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

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

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