PyCharm 2025.3 ヘルプ

自動インポート

インポートされていないクラスを参照すると、PyCharm はこのファイルを見つけてインポートのリストに追加できます。設定に応じて、単一のクラスまたはパッケージ全体をインポートできます。

import ステートメントが imports セクションに追加されますが、キャレットは現在の位置から移動せず、現在の編集セッションは中断されません。この機能はインポートアシスタントとして知られています。インポートアシスタントの使用は、PyCharm でのインポートを処理するための推奨される方法です。これは、インポートの最適化がコマンドラインを介してサポートされていないためです。

同じ可能性が XML ファイルにも当てはまります。バインドされていない名前空間を持つタグを入力すると、インポートアシスタントは名前空間の作成を提案し、適切な選択肢のリストを提供します。

インポートステートメントを自動的に追加する

選択肢がない場合は、インポート文を自動的に追加するように IDE を設定できます。

  1. Ctrl+Alt+S を押して設定を開き、エディター | 一般 | 自動インポートを選択します。

  2. Python セクションで、自動インポートを構成します。

    • import ステートメントがないクラスの名前を結ぶときにインポートポップアップを自動的に表示するには、インポートポップアップを表示するを選択します。

    • 優先インポートスタイルオプションの 1 つを選択して、インポートステートメントを生成する方法を定義します。

インポートツールチップを無効にする

ツールチップが無効になっている場合、未解決の参照には下線が引かれ、赤いバルブアイコン the Quick-fix button でマークされます。提案のリストを表示するには、このアイコンをクリックして(または、Alt+Enter を押して)、クラスのインポートを選択します。

すべてのツールチップを無効にする

  • エディターの右上隅にあるインスペクションウィジェットの上にマウスを置き、More をクリックして、自動インポートツールチップを表示オプションを無効にします。

自動インポートを無効にする

自動インポートを完全に無効にする場合は、次のことを確認してください。

インポートの最適化

インポートの最適化機能を使用すると、設定 | エディター | コードスタイル | <言語> | インポートで指定されたルールに従って、未使用のインポートを削除し、現在のファイルまたはディレクトリ内のすべてのファイルのインポートステートメントを一度に整理できます。

すべてのインポートを最適化する

  1. プロジェクトツールウィンドウ(表示 | ツールウィンドウ | プロジェクト)でファイルまたはディレクトリを選択します。

  2. 以下のいずれかを行います。

    • メインメニューで、コード | インポートの最適化に移動します (または Ctrl+Alt+O を押します)。

    • コンテキストメニューからインポートの最適化を選択します。

  3. (ディレクトリを選択した場合)ディレクトリ内のすべてのファイルでインポートを最適化するか、ローカルで変更されたファイルのみでインポートを最適化するか(プロジェクトがバージョン管理下にある場合)を選択し、実行をクリックします。

1 つのファイルでインポートを最適化する

  1. キャレットをインポートステートメントに置き、Alt+Enter を押すか、the Intention action button アイコンを使用します。

  2. インポートの最適化を選択します。

Remove use statement

コミット時にインポートを最適化する

プロジェクトがバージョン管理されている場合は、変更されたファイルを VCS にコミットする前に、PyCharm を構成して、変更されたファイルのインポートを最適化できます。

  1. Alt+0 を押してコミットツールウィンドウを開き、コミットオプションを表示 the Settings button をクリックします。

  2. Show Commit Options をクリックし、コミットメッセージ領域でインポートの最適化チェックボックスを選択します。

    Optimize imports before commit

保存時にインポートを自動的に最適化する

変更が保存されたときに、変更されたファイルへのインポートを自動的に最適化するように IDE を構成できます。

  1. Ctrl+Alt+S を押して設定を開き、ツール | 保存時のアクションを選択します。

  2. インポートの最適化オプションを有効にします。

    さらに、すべてのファイルタイプリストから、インポートを最適化するファイルのタイプを選択します。

  3. 変更を適用し、ダイアログを閉じます。

ファイルの再フォーマット時にインポートを最適化する

再フォーマットされるたびに、ファイル内のインポートを最適化するように PyCharm に指示できます。

  • エディターでファイルを開き、Ctrl+Alt+Shift+L を押して、開いたファイルの整形ダイアログでインポートの最適化チェックボックスが選択されていることを確認します。

    Reformat file dialog

その後、このプロジェクトで Ctrl+Alt+L を押すたびに、PyCharm はインポートを自動的に最適化します。

フォルダー内のすべてのファイルのインポートを最適化する

  1. プロジェクトツールウィンドウでフォルダーを右クリックし、インポートの最適化を選択します。

  2. インポートの最適化ダイアログで、実行をクリックします。

オンザフライでインポートを作成する

オンザフライでパッケージをインポートする

  1. エディターで名前の入力を開始します。名前がインポートされていないクラスを参照する場合は、次のプロンプトが表示されます。

    the Import popup

    未解決の参照には下線が引かれ、インテンションアクションインポートの追加を明示的に呼び出す必要があります。

  2. Alt+Enter を押します。複数の選択肢がある場合は、リストから目的のインポートを選択します。

    choose a class to import

プロジェクト設定(設定 | エディター | 一般 | 自動インポート)の自動インポートページで使用可能な次のオプションを使用して、Python コードの優先インポートスタイルを定義できます。

from <モジュール> import <名前>

import <モジュール>.<名前>

the from <module> import <name> style
the import <module>.<name> style

相対インポートと絶対インポートの切り替え

PyCharm は、ソースルート内で相対インポートと絶対インポートを整理できます。特定のインテンションを使用すると、絶対インポートを相対インポートに変換し、相対インポートを絶対インポートに変換できます。

Converting an absolute import into relative

コードに相対インポートステートメントが含まれている場合、PyCharm は欠落しているインポートを修正するときに相対インポートを追加します。

Fixing a missing import with the relative import statement

相対インポートは現在のソースルート内でのみ機能することに注意してください。別のソースルートからパッケージを相対的にインポートすることはできません。

インポートの変換を促すインテンションはデフォルトで有効になっています。無効にするには、プロジェクト設定Ctrl+Alt+S)を開き、エディター | インテンションを選択し、絶対インポートを相対インポートに変換するおよび相対インポートを絶対に変換する選択を解除します。

Intentions for converting imports

ES6 シンボルまたは CommonJS モジュールを完了すると、PyCharm はインポートステートメント自体のスタイルを決定するか、必要なスタイルを選択できるポップアップを表示します。JavaScript で自動インポートから詳細を参照してください。

コード補完にインポートステートメントを追加する

Python コードでモジュールメンバーまたはパッケージを参照してコード補完を呼び出すと、PyCharm は自動的にインポートステートメントを追加します。コード補完での自動インポートは、numpy の場合は nppandas の場合は pd など、いくつかの一般的なパッケージ名エイリアスにも適用されます。

PyCharm は、エクスポートされた JavaScript または TypeScript シンボルを完了すると、インポートステートメントも追加します。

Add ES6 imports on code completion

完了時に自動インポートを構成する

完了時に自動インポートを無効にして、代わりにクイックフィックスを使用することができます。

Add ES6 imports on code completion
  1. 設定ダイアログ(Ctrl+Alt+S)で、エディター | 一般 | 自動インポートに移動します。

  2. 開いた自動インポートページで、TypeScript/JavaScript 領域のチェックボックスを使用して、コード補完でのインポート生成を有効または無効にします。

欠落しているインポートステートメントを無視する

対応するスタブがないモジュールをコードで使用すると、PyCharm でステートメントの欠落エラーが表示される場合があります。このエラーメッセージを抑制するには、# type: ignore コメントを使用します。

Ignore a missing import statement
2025 年 10 月 29 日

関連ページ:

XML

PyCharm は、構造検証、フォーマット () およびインデント (XML コードスタイルによる)、バインドされていない名前空間のインポート、コード構造の表示、タグのアンラップと削除 ()、インスタンスドキュメントからの DTD ファイルおよびスキーマの生成など、XML の強力なサポートをもたらします。構文とエラーのハイライト、コード補完 ()、インテンションアクション ()、クイックドキュメントルックアップ () など。PyCharm は、Apache Software Foundation グループに...

コードの再フォーマットと再配置

PyCharm を使用すると、現在のコードスタイルスキームまたは .editorconfig ファイルで指定した要件に従ってコードを再フォーマットできます。で定義されていないものがあれば、プロジェクト設定から取得されます。コードの一部、ファイル全体、ファイルのグループ、ディレクトリ、モジュールを再フォーマットできます。また、コードの一部または一部のファイルを再フォーマットから除外することもできます。PyCharm は、Python コードの配置とフォーマットに関する PEP 8 のルールと要件に準拠して...

JavaScript

PyCharm を使用すると、JavaScript および Node.js を使用して最新の Web、モバイル、デスクトップアプリケーションを開発できます。PyCharm は、React、Angular、Vue.js、その他のフレームワークもサポートし、Web 開発用のさまざまなツールとの緊密な統合を提供します。JavaScript 対応のコーディング支援には、キーワード、ラベル、変数、パラメーター、関数の補完、エラーと構文のハイライト、フォーマット、コードインスペクションおよびクイックフィックス、お...

コード補完

基本コード補完は、可視性スコープ内のクラス、メソッド、キーワードの名前を補完するのに役立ちます。PyCharm はコンテキストを分析し、現在のキャレット位置から到達可能な選択肢を提案します。候補にはライブテンプレートも含まれます。補完機能は英語以外のキーボードレイアウトでも利用できます。基本補完を呼び出すデフォルトでは、PyCharm は入力時に自動的にコード補完ポップアップを表示します。あるいは、を押すか、メインメニューからを選択することもできます。基本コード補完を 2 回呼び出すと、依存関...