インスペクションを実行する

PyCharm はエディターで開かれているファイルのコードを分析し、入力するたびに問題のあるコードをハイライトします。さらに、選択したファイル範囲に対して必要なインスペクションまたは一連のインスペクションを手動で実行できます。この場合、ファイル内で検出されたすべての問題に関する包括的なレポートが得られます。

現在のファイルの即時分析

IDE は継続的にコードをチェックし、問題を検索します。エディターの右上隅にあるウィジェットには、現在のファイルで検出された各重大度の問題の数が表示されます。

ウィジェットをクリックすると、ファイルタブの問題ツールウィンドウで問題のリストが開きます。表示 | ツールウィンドウ | 問題を選択するか、 Alt+6 を押して、問題ツールウィンドウにアクセスすることもできます。

各問題について、 Alt+Enter を押すか、をクリックすると、提案されたクイックフィックスが表示されます。エディターの対応する行に移動するには、 F4 を押すか、ツールウィンドウで問題をダブルクリックします。

をクリックすると、ツールウィンドウで問題を表示して修正できるようになります。

スクロールバーのカラーストライプは、検出されたコードの問題を示し、ファイルをスクロールせずに対応する行にすばやくアクセスできます。ストライプ上のマークにカーソルを合わせると、ツールチップで検出された問題が表示されます。マークをクリックすると、対応する行に移動します。

検出された問題に移動する

ウィジェットでをクリックするか、それに応じて F2 または Shift+F2 を押すと、ファイル内でハイライトされた問題から別の問題に移動できます。デフォルトでは、IDE は重大度に応じて問題に移動します: エラー> 警告> 弱い警告> サーバーの問題> タイプミス。

重大度に関係なく、PyCharm で問題を順番に確認できるように設定できます。エディターの右上隅にあるウィジェットの上にマウスを置き、をクリックし、 '次のエラー' アクション (F2) 実行を選択して、すべての問題を有効にします。

インスペクションを手動で実行する

いくつかのインスペクションはグローバルコード分析を必要とし、それらがエディターで無効にされる理由です。これらのインスペクションは設定 | エディター | インスペクションにリストされています。をクリックしてバッチモードのインスペクションのみ表示を選択します。

コード内のすべての問題の完全なレポートを取得するには、インスペクションを手動で実行します。この場合、IDE はインスペクションプロファイルで有効になっているすべてのインスペクションを実行し、専用ツールウィンドウに結果を表示します。分析を完了するのに必要な時間は、有効になっているインスペクションの数と分析するスコープのサイズによって異なります。

すべて実行インスペクション

メインメニューでコード｜コードのインスペクション… へ移動します。
分析するファイルの範囲を選択します。
アイコンをクリックして、新しいスコープを構成します。
適用するインスペクションプロファイルを選択します。
新しいプロファイルを作成するか、既存のプロファイルの 1 つを変更するには、構成… をクリックします。
分析をクリックして解析を開始します。

インスペクションスコープの指定ダイアログ

項目	説明
プロジェクト全体	プロジェクト全体の検査。
モジュール <name>；	プロジェクトツールウィンドウ（`Alt+1` ）で現在選択されているモジュールをインスペクションします。
ファイル <名前>	プロジェクトツールウィンドウで現在選択されているか、エディターで開かれているファイルを調べます。
選択したファイル	プロジェクトツールウィンドウで現在選択されているファイルを調べます。
未コミットのファイル	このスコープは、バージョン管理下のプロジェクトでのみ使用できます。バージョン管理システムにコミットされていないファイルのみをインスペクションします。
ディレクトリ	プロジェクトツールウィンドウで現在選択されているディレクトリを調べます。
カスタムスコープ	ファイルのカスタムスコープをインスペクションします。リストから定義済みのスコープを選択するか、をクリックして、開いたスコープダイアログでスコープを定義します。特別な言語を使用してスコープを定義します。
挿入コードを検査	コードに埋め込まれた他の言語のコードをインスペクションします。
インスペクションプロファイル	コードのインスペクションに使用するプロファイルを選択します。必要なプロファイルがリストにない場合は、構成をクリックして新しいプロファイルを作成します。

シングルインスペクションを実行

単一のインスペクションを実行すると、特定の問題を追跡する場合に役立ちます。ファイル内で警告が見つかった場合は、プロジェクト全体またはファイルの必要な範囲をインスペクションして、コードベースにそのような警告がないことを確認できます。

Ctrl+Alt+Shift+I を押すか、メインメニューでコード｜コードの解析｜名前でインスペクションを実行… を選択します。
ポップアップにインスペクション名を入力します。キャメルハンプを使用して、キャメルケースの単語と空白を単語の最初の文字と一致させます。候補リストには、検索要求に一致するインスペクションが表示されます。
正しいインスペクションを選択しているかどうかわからない場合は、その説明を表示できます。これを行うには、ポップアップでインスペクションを選択し、 Ctrl+Q を押します。
必要なインスペクションをダブルクリックします。
表示されるダイアログで、分析するファイルの範囲を選択します。
ファイルマスク（複数可）オプションを使用すると、インスペクションするファイルの数を絞り込むことができます。
チェックボックスを選択し、分析するファイルの名前に一致する文字とワイルドカードのパターンを指定します。複数のファイルマスクを区切るには、コンマを使用します。
一部のインスペクションには、設定を求められる追加オプションがあります。
これらの設定はこの実行にのみ適用され、現在のプロファイルのこのインスペクションの構成には影響しません。
IDE は、インスペクションの結果を専用のツールウィンドウツールウィンドウに表示します。そこで、検出された問題を調べて修正できます。

コミット時にコードを分析する

プロジェクトが Git または Mercurial バージョン管理下にある場合は、変更されたファイルをコミットする前に IDE を分析するよう設定できます。

Alt+0 を押してコミットツールウィンドウを開き、コミットオプションを表示をクリックします。
コミットチェック領域で、コードを解析チェックボックスを選択します。
プロファイルの選択をクリックし、IDE がインスペクションを実行するために必要なインスペクションプロファイルを選択します。
コミットをクリックしてください。
PyCharm は、選択したプロファイルのインスペクションを実行することにより、変更されたファイルのコードを分析します。
エラーや警告が検出された場合、通知が表示されます。
通知で、コード解析のレビューをクリックして、メッセージツールウィンドウで検出された問題のリストを表示します。無視をクリックして、検出された問題を修正せずに変更をコミットします。

コードインスペクションを Qodana で実行する

この機能は Qodana プラグインに依存しており、PyCharm にはデフォルトでバンドルされ有効化されています。関連機能が利用できない場合は、プラグインが無効になっていないことを確認してください。詳細については、プラグイン設定を開くを参照してください。

Qodana を使用して、コードをローカルまたはリモートでインスペクションできます。 Qodana の主な使用例は、CI/CD サーバー上でリソースを大量に消費するコード分析をリモートで実行することです。ただし、IDE で同じ分析を実行して、同じ結果が得られることを確認し、ソースコード内で検出された問題を特定することもできます。

メインメニューでツール | Qodana | Qodana でコード解析を試すへ移動します。
インスペクションを実行する場所を選択してください：ローカルまたは CI/CD サーバー。
サーバー上でインスペクションを実行するには、まず CI で Qodana をセットアップする必要があります。
Qodana 設定ファイルが開きます。このファイルでは、Qodana インスペクションプロファイルを指定し、特定のインスペクションを有効または無効にし、分析前にインストールする必要があるプラグインのリストを指定できます。
実行をクリックしてください。

分析が完了すると、 Qodana タブの問題ツールウィンドウにレポートが表示されます。結果をローカルで操作することも、 Qodana クラウド(英語)に送信することもできます。

Qodana 分析のすべてのローカル実行のレポートは保存され、メインメニューツール | Qodana | [report name] から利用できます。現在開いているレポートの横にはチェックマークが付いており、それをクリックしてレポートを閉じることができます。

Qodana の詳細については、そのドキュメントを参照してください。

インスペクションをオフラインで実行する

IDE からコードインスペクションを実行することに加えて、実際に PyCharm を実行せずにコマンドラインからインスペクションを起動することもできます。インスペクションの結果は XML ファイルに保存されます。詳細については、コマンドラインからコードインスペクションを実行するを参照してください。

スコープの順序を変更する

デフォルトでは、すべての有効なコードインスペクションがプロジェクト内のすべてのファイルを解析します。必要に応じて、同じインスペクションを異なる設定のファイルの複数のスコープで実行することができます。

ファイルが複数のスコープに含まれていて、これらのスコープでインスペクションを有効にした場合、PyCharm はリスト内の順序に基づいて処理します。一番上のスコープは優先順位が最も高く、最初に分析されます。

設定ダイアログ（Ctrl+Alt+S ）で、エディター | インスペクションを選択します。
リストから任意のインスペクションを選択します。
すべてのスコープリストからスコープ順序の編集を選択してください。
必要な範囲を選択し、とを使ってリストを上下に移動します。
必要に応じて、新しいスコープを作成します。これを行うには、（スコープの編集… ）をクリックし、スコープ設定を指定し、スコープ設定に含めるファイルとフォルダーを選択します。

2026 年 7 月 14 日