PyCharm 2026.2 Help

Python ツールサポート

Python LSP プラグインを有効化

この機能は、デフォルトで PyCharm にバンドルされて有効になっている Python LSP プラグインに依存しています。 関連機能が利用できない場合は、プラグインが無効になっていないことを確認してください。

  1. Ctrl+Alt+S を押して設定を開き、 プラグイン​ を選択します。

  2. インストール済み タブを開き、 Python LSP プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。

PyCharm は、コードの品質、保守性、ワークフローの効率を向上させるいくつかのツールをサポートしています:

  • Ruff: エラーを検出し、コーディング標準を強制する高性能リンターおよびフォーマッター。

  • Pyrightbasedpyright および ty :リアルタイムの型解析を行う高速型チェッカー。

  • Black: 一貫したスタイルを維持するのに役立つ自動コードフォーマッター。

Python ファイルを開いているとき、アクティブな LSP ツールが下部ツールバーに表示されます:

ツールバーに表示される Python LSP ツール

プロジェクトのインタープリターで Python ツールが検出されると、PyCharm によりツールの有効化を提案する通知が表示されます。 通知をクリックすると、設定を開かずにツールを有効化できます。

外部ツール設定ページ。

すべての対応した外部ツールは、単一のページで設定されます: Python | ツール | 外部ツール。 ページには、PyCharm で現在サポートされているすべてのツール(リンター、型チェッカー、フォーマッター)が表として表示されます。

各ツールについて、表には同じコントロールセットが表示されます:

  • ツールの統合を有効化または無効化するには、 オン/オフ 切り替え を使用します。

  • ツールごとの 機能 ウィジェットでは、エディターでツールが提供する機能(例:インスペクション、補完、インレイヒント、フォーマット、インポート最適化など)を選択できます。 利用可能な機能の一覧は、ツールによって異なります。

  • 呼び出し順序 は、PyCharm がツール実行可能ファイルを見つける方法を制御します。 ソースは次の順序で試されます:

    1. SDK :現在選択されているプロジェクトインタープリターにインストールされたツールパッケージ。

    2. パス :システムの $PATH にある実行可能ファイル、または指定したパス。

    3. uvx :PyCharm は uv を介してツールを実行し、インタープリターへのインストールは行いません。

    特定のツールについて、個々のソースを並べ替えたり無効化したりできます。

  • パス フィールドには 参照…参照… アイコンが表示されます。 ツールがまだインストールされていない場合、パスの横に インストールする ボタンが表示され、設定ページを離れることなく選択したインタープリターにパッケージを追加できます。

ラフ

Ruff (英語) は、入力中に問題点をハイライト表示し、修正を提案し、プロジェクト全体で一貫したコード品質を維持できます。 高速に実行され、エディター内で直接リアルタイムのフィードバックを提供します。

PyCharm の Ruff サポートには以下が含まれます:

  • フォーマット

  • インポートの最適化

  • クイックフィックス

  • 構成ファイルの検証

  • ルールコードのインレイヒント

    ルールコードのインレイヒントを表示する
  • ルールコードと構成オプションの補完

    自動補完を使用する
  • ルールコードと構成オプションの Web リンク

    Ctrl (macOS では )を押し、ルールコードまたは構成オプションをクリックすると、 Ruff ドキュメント の該当ページが開きます。

  • ルールコードと構成オプションのエディター内ドキュメントプレビュー

    エディターでドキュメントをプレビューする

以下の Ruff オプションを有効にできます:

パイフライ

Pyrefly(英語) は、Python 用の型チェッカーおよび言語サーバーです。

以下の Pyrefly オプションを有効にできます:

Pyright

Pyright(英語) は Python の静的型チェッカーです。

以下の Pyright オプションを有効にできます:

basedpyright

basedpyright (英語) は、さまざまな型チェックの改善を加えた Pyright のフォークです。

以下の basedpyright オプションを有効にできます:

新しいエラーをベースラインに書き込む

ベースライン(英語)は、現在の型チェックエラーのセットを保存して、型カバレッジを徐々に改善しながら新しいエラーが導入されるのを防ぐ方法です。

PyCharm でベースラインを使用するには:

  1. basedpyright を有効にします。

  2. プロジェクト内で、basedpyright 型チェックエラーが含まれるファイルを開きます。

  3. ヘルプ | アクションの検索 に移動し (または Ctrl+Shift+A を押して)、 ベースコピーライト: 新しいエラーをベースラインに書き込む を検索して選択します。

    .basedpyright ディレクトリに baseline.json ファイルが作成され、basedpyright はそこにリストされているエラーを無視しながら、新しいタイプのエラーを報告し続けます。

ありがとう

ty(英語) は Rust で書かれた高速な Python 型チェッカーです。 現在はプレビュー段階であり、不完全な可能性があります。

以下の ty オプションを有効にできます:

Black

Black を使用して、PyCharm で Python コードをフォーマットできます。

ブラックフォーマッタの設定は pyproject.toml ファイルで設定できます。 詳細については、 黒のドキュメント(英語)を参照してください。

詳細については、 ブラック CLI リファレンス(英語)を参照してください。

2026 年 7 月 14 日