Python ツールサポート
PyCharm は、コードの品質、保守性、ワークフローの効率を向上させるいくつかのツールをサポートしています：
Ruff: エラーを検出し、コーディング標準を強制する高性能リンターおよびフォーマッター。
Pyright、 basedpyright、 Pyrefly、 ty: リアルタイムの型解析を提供する高速な型チェッカー。
Black: 一貫したスタイルを維持するのに役立つ自動コードフォーマッター。
Python ファイルを開いているとき、アクティブな LSP ツールが下部ツールバーに表示されます：
プロジェクト環境で Python ツールが検出されると、PyCharm はツールの有効化を提案する通知を表示します。 通知をクリックすると、設定を開かずにツールを有効化できます。
外部ツール設定ページ。
すべての対応した外部ツールは、単一のページで設定されます： 。 ページには、PyCharm で現在サポートされているすべてのツール（リンター、型チェッカー、フォーマッター）が表として表示されます。
各ツールについて、表には同じコントロールセットが表示されます：
ツールの統合を有効化または無効化するには、 オン／オフ 切り替え を使用します。
検索 列には、PyCharm がツールの実行可能ファイルを見つける方法が表示されます。 PyCharm は次の順序でソースを試し、ツールが見つかった最初のソースを使用します:
環境: プロジェクト環境にインストールされているツールパッケージ。 プロジェクトに複数の環境がある場合、 環境 には、たとえば 環境 (1/3) のように、そのうちいくつにツールがあるかも表示されます。
パス ：システムの
$PATHにある実行可能ファイル、または指定したパス。uvx: PyCharm は、環境にインストールせずに uv を介してツールを実行します。
PyCharm が使用するソースは太字で表示されます。 有効化されたツールがどのソースにも見つからない場合、検索チェーン全体が赤で表示されます。
ツール構成の追加設定。
追加設定を開くには、ツール名の横にある
をクリックするか、ツールの行をクリックします。
ツールごとの 機能 リストでは、ツールがエディターで提供する機能 (たとえば、インスペクション、補完、インレイヒント、フォーマット、インポートの最適化) を選択できます。 利用可能な機能の一覧は、ツールによって異なります。
環境 セクションには、各プロジェクト環境とツールのパスおよびバージョンが一覧表示されます。 ツールが環境にインストールされていない場合、環境名の横に 未インストール と インストールする リンクが表示されます。 インストールする をクリックして、この環境にツールをインストールします。
パス 行には、実行可能ファイルへのパスとそのバージョンが表示されます。 別の実行可能ファイルを選択するには、
(実行可能ファイルを参照) をクリックします。ツールの状態に応じて、次のリンクのいずれかがパスの横に表示されます:
インストールする: ツールをインストールし、グローバルに使用します。
アップグレード: ツールを新しいバージョンにアップグレードします。
自動検出を使用する: 手動で選択した実行可能ファイルを破棄し、ツールを自動的に検出します。
basedpyright
basedpyright (英語) は、さまざまな型チェックの改善を加えた Pyright のフォークです。
以下の basedpyright オプションを有効にできます：
新しいエラーをベースラインに書き込む
ベースライン(英語)は、現在の型チェックエラーのセットを保存して、型カバレッジを徐々に改善しながら新しいエラーが導入されるのを防ぐ方法です。
PyCharm でベースラインを使用するには：
basedpyright を有効にします。
プロジェクト内で、basedpyright 型チェックエラーが含まれるファイルを開きます。
に移動し (または Ctrl+Shift+A を押して)、 を検索して選択します。
basedpyright は baseline.json ファイルを .basedpyright ディレクトリに作成します。 このファイルに一覧表示されているエラーは無視され、新しい型エラーの報告は継続されます。
Black
Black を使用して、PyCharm で Python コードをフォーマットできます。
ブラックフォーマッタの設定は pyproject.toml ファイルで設定できます。 詳細については、 黒のドキュメント(英語)を参照してください。
引数 フィールドを使用して追加のオプションを指定したり、pyproject.toml の設定を上書きしたりすることもできます。
詳細については、 ブラック CLI リファレンス(英語)を参照してください。
パイフライ
Pyrefly(英語) は、Python 用の型チェッカーおよび言語サーバーです。
以下の Pyrefly オプションを有効にできます：
Pyright
Pyright(英語) は Python の静的型チェッカーです。
以下の Pyright オプションを有効にできます：
ラフ
Ruff (英語) は、入力中に問題点をハイライト表示し、修正を提案し、プロジェクト全体で一貫したコード品質を維持できます。 高速に実行され、エディター内で直接リアルタイムのフィードバックを提供します。
PyCharm の Ruff サポートには以下が含まれます：
フォーマット
インポートの最適化
クイックフィックス
構成ファイルの検証
ルールコードのインレイヒント
ルールコードと構成オプションの補完
ルールコードと構成オプションの Web リンク
Ctrl （macOS では ⌘ ）を押し、ルールコードまたは構成オプションをクリックすると、 Ruff ドキュメント の該当ページが開きます。
ルールコードと構成オプションのエディター内ドキュメントプレビュー
以下の Ruff オプションを有効にできます：
整形時にインポートをソートする: フォーマット が有効な場合、ファイル全体を整形するときに Ruff はインポートも並べ替えます。 未使用のインポートは削除されません。
保存時にコードフィックスを実行する: Python ファイルを保存すると、Ruff はプロジェクトで有効化されているルールに対して 安全な修正 を適用します。
Ruff 修正をスコープに適用
Ruff の安全な修正を、プロジェクト、モジュール、ディレクトリ、カスタムスコープ内のすべての Python ファイルに一度に適用できます。
Ruff を 外部ツール設定ページで有効化します。
メインメニューで へ移動します。
開いたダイアログでスコープを選択し、 分析 をクリックします。
Ruff は、プロジェクトで有効化されているルールに対する安全な修正を、スコープ内の Python ファイルに適用します。 すべての変更を元に戻すには、 Ctrl+Z を押します。
ありがとう
ty(英語) は Rust で書かれた高速な Python 型チェッカーです。 現在はプレビュー段階であり、不完全な可能性があります。
以下の ty オプションを有効にできます：