PyCharm 2026.3 Help

プラグイン​

プラグインは PyCharm のコア機能を拡張します。 たとえば、プラグインをインストールして、IDE をバージョン管理システム、課題トラッカー、ビルド管理サーバーと統合したり、さまざまな言語やフレームワークのコーディング支援サポートを利用したりできます。

ほとんどのプラグインは、どの JetBrains 製品でも使用できます。 有償製品のみに限定されているものもあれば、別のライセンスが必要なものもあります。

プラグインのインストール

デフォルトでは、PyCharm にはインストールの一部として IDE に付属するバンドルプラグインが含まれています。 JetBrains Marketplace またはローカルアーカイブファイル (ZIP または JAR) から追加のプラグインをインストールできます。 これらの追加プラグインは、非バンドルプラグインまたはダウンロード済みプラグインと呼ばれます。

マーケットプレイスからプラグインをインストールする

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

  2. 検索フィールドにインストールするプラグインの名前を入力します。

    検索フィールドの Marketplace の結果を表示 をクリックすると、検索結果を並べ替えるオプションが表示されます。 プラグインの絞り込み をクリックすると、利用可能なフィルターオプションが表示されます。

  3. プラグインをインストールするには、 インストールする をクリックし、求められた場合は IDE を再起動します。

特定のバージョンをインストールするには、 JetBrains マーケットプレイス(英語)のプラグインページに移動し、 ディスクからプラグインをインストール の説明に従ってダウンロードしてインストールします。 例: 最新バージョンのプラグインが壊れている場合でも実行できます。

プラグイン設定を開く

  • 設定を開くか、IDE で Ctrl+Alt+S を押してから プラグイン​ を選択します。

ここでは、いくつかのプラグインカテゴリを確認できます:

  • インストール済み: JetBrains Marketplace、カスタムプラグインリポジトリ、またはローカルアーカイブからインストールされた追加プラグイン。

  • バンドル: PyCharm にデフォルトで含まれているプラグイン。 ほとんどは有効化または無効化できますが、アンインストールはできません。

  • 推奨: 現在のプロジェクトで検出されたテクノロジーに基づいて PyCharm が 推奨するプラグイン。

  • マーケットプレース: JetBrains Marketplace からインストールできるプラグイン。 これらのプラグインは、プラグインを検索すると検索結果として表示されます。

  • 使用している場合は、 カスタムリポジトリから提供されるプラグイン。

スタッフのおすすめに JetBrains AI Assistant、Spark、Kubernetes があり、Databricks の詳細が表示されているプラグイン設定。

プラグインが他のプラグインに依存している場合は、「追加情報 」タブで依存関係のリストを見つけることができます。 project が特定のプラグインに依存している場合は、 必要なプラグインのリストに追加してください。

ディスクからプラグインをインストール

JetBrains Marketplace からダウンロードした特定のプラグインバージョン、またはサードパーティが提供するプラグインが必要な場合は、ディスクからプラグインをインストールできます。 この場合、ローカルの ZIP または JAR アーカイブからプラグインをインストールします。

  1. プラグインアーカイブ(ZIP または JAR)をダウンロードします。

  2. 設定を開くか、IDE で Ctrl+Alt+S を押してから プラグイン​ を選択します。

  3. プラグイン​ ページで、 設定ボタンリポジトリの管理、プロキシの構成、またはディスクからプラグインをインストール をクリックしてから ディスクからプラグインをインストール をクリックします。

    プラグイン設定ページで設定メニューが開いており、「ディスクからプラグインをインストール」オプションが表示されています。
  4. プラグインアーカイブファイルを選択して OK をクリックします。

  5. プロンプトが表示されたら、 OK をクリックして変更を適用し、IDE を再起動します。

コマンドラインからプラグインをインストール

IDE セットアップを自動化したい場合や、グラフィカルインターフェースを使用せずにプラグインをインストールしたい場合は、コマンドラインからプラグインをインストールします。

  1. プラグインをインストールする IDE を終了します。

  2. JetBrains マーケットプレイス(英語)で、インストールするプラグインのページを見つけ、 追加情報 セクションまで下にスクロールして、 プラグイン ID パラメーターの値をコピーします (例: org.jetbrains.plugins.github)。

  3. プラグインのインストール:

    PyCharm インストールディレクトリの bin ディレクトリに移動し、次のコマンドを実行します。

    pycharm64.exe installPlugins <PluginID>

    例:

    pycharm64.exe installPlugins org.jetbrains.plugins.github

    次のコマンドを実行してください:

    open -na "PyCharm.app" --args installPlugins <PluginID>

    例:

    open -na "PyCharm.app" --args installPlugins org.jetbrains.plugins.github

    PyCharm インストールディレクトリの bin ディレクトリに移動し、次のコマンドを実行します。

    pycharm.sh installPlugins <PluginID>

    例:

    pycharm.sh installPlugins org.jetbrains.plugins.github

詳細については、 コマンドラインからプラグインをインストールする を参照してください。

プラグインの更新

プラグインを手動で更新する

構成済みの更新ソースがあるプラグインでは、プラグインの更新を利用できます。

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

  2. インストールされているプラグインの新しいバージョンが利用可能な場合は、プラグイン設定に 更新 ボタンが表示されます。 これをクリックしてプラグインを更新します。

IDE がアップデートを確認するかどうかを設定するには、 設定 Ctrl+Alt+S を開いて 外観 & 振る舞い | システム設定 | 更新 に移動します。 このページで 更新の確認 をクリックして、プラグインリポジトリで利用可能なプラグインアップデートを手動で確認することもできます。

IDE ですべてのプラグインを自動的に更新したい場合は、 それに応じて設定できます。

IDE やプラグインの更新について詳しくは、 PyCharm を更新 をご参照ください。

プラグインを自動的に更新する

デフォルトでは、PyCharm はプラグインの新しいバージョンが利用可能になると、手動で更新するよう通知します。 PyCharm を設定すると、プラグインの更新を自動でダウンロードし、次回の IDE 再起動時に適用できます。

構成済みの更新ソースがあるプラグインでは、プラグインの自動更新を利用できます。 この場合、PyCharm は指定されたリポジトリで更新を確認し、他のリポジトリからの更新は自動的にインストールしません。

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

  2. 設定ボタンリポジトリの管理、プロキシの構成、またはディスクからプラグインをインストール をクリックし、 プラグインを自動的に更新する を選択します。

    または、 外観 & 振る舞い | システム設定 | 更新 に移動して プラグインを自動的に更新する を選択します。

プラグインのアップデートソース

PyCharm はソースが既知のプラグインのみを更新します。 JetBrains Marketplace またはカスタムプラグインリポジトリからプラグインをインストールすると、PyCharm はそのリポジトリをプラグインソースとして記録します。

プラグインに更新ソースが構成されていない場合、PyCharm は自動的に更新したり、更新が利用可能になったときに通知したりしません。 これは、たとえばディスクからプラグインをインストールした場合や、IDE が以前にインストールされたプラグインのソースを特定できない場合に発生することがあります。

PyCharm がプラグインの更新を停止した場合、ソースを設定するためのリンクを含む通知が表示されます。 それ以外の場合は、設定でソースを確認できます。

プラグインの更新ソースを確認または変更する

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

  2. インストール済みプラグインを選択し、 追加情報 タブを開きます。

  3. プラグインの更新ソースを表示または変更するには、 アップデート取得元 フィールドを見つけます。

    信頼でき、プラグインの更新を受け取りたいリポジトリを選択します。

プラグインの非アクティブ化

プラグインの無効化

対応する機能が不要でも IDE からプラグインをアンインストールしたくない場合は、プラグインを削除せずに無効化できます。

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

  2. 無効化するプラグインを見つけて選択します。

  3. プラグインの説明ペインで 無効化 をクリックします。

    または、プラグインリストのトグルボタンや、プラグインカテゴリ用の すべて無効化 ボタンを使用できます。

設定ボタンリポジトリの管理、プロキシの構成、またはディスクからプラグインをインストール の下のメニューで、すべての非バンドルプラグインを一度に無効化または有効化できます。

ダウンロードしたプラグインをすべて無効にする

プラグインのアンインストール

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

  2. アンインストールするプラグインを見つけて選択します。

  3. 無効化 リストを展開し、 アンインストール を選択します。

    プラグインのアンインストール

必須プラグイン

プロジェクトには、特定のテクノロジーまたはフレームワークをサポートするプラグインが必要な場合があります。 そのようなプラグインを現在のプロジェクトの 必要なプラグインリストに追加して、PyCharm がプラグインのインストールと有効化を確認できるようにすることができます。 プラグインを忘れた場合、またはチームの誰かがプロジェクトで作業しているときに依存関係を認識していない場合に通知されます。

現在のプロジェクトに必要なプラグインを追加する

  1. Ctrl+Alt+S を押して設定を開き、 外観 & 振る舞い | 必須プラグイン を選択します。

  2. 必須プラグイン ページで、 追加アイコン追加 をクリックし、プラグインを選択します。 必要に応じて、プラグインの最小バージョンと最大バージョンを指定します。

    必要なプラグインを追加するダイアログ

必要なプラグインのリストは、プロジェクトの .idea/externalDependencies.xml ファイルに保存されています。 project を PyCharm で開くと、必要なプラグインが無効になっているか、インストールされていないか、更新が必要な場合は通知されます。

必要なプラグインが無効になっています

通知メッセージ内のリンクをクリックして、必要なプラグインを有効化、インストール、または更新します。

推奨プラグイン

project を開くと、PyCharm が project で使用されているライブラリに基づいて、プラグインのインストールと有効化を提案できます。 提案されたプラグインと、チームメートも使用できるように project に手動で追加できる 必要なプラグインを混同しないでください。

特定のプラグインが不要な場合は、PyCharm がそのプラグインを提案しないようにできます。 通知設定を使用して、すべてのプラグイン候補とその表示方法の通知を無効または有効にすることもできます。

プラグインの提案を無効にする

  • 提案されたプラグインの通知が表示されたら、 今後提案しない をクリックします。

次回 project を開いたとき、PyCharm はこのプラグインを提案しません。

プロジェクトで推奨されているプラグインを確認する

提案を無効にしたプラグインを除き、プロジェクトで提案されたプラグインを確認できます。

  1. Ctrl+Shift+A を押して、 Check Suggested Pluginsと入力し始めます。

  2. 推奨プラグインの確認 アクションを選択します。

    アクションへ移動のポップアップで「提案されたプラグインをチェック」が最上位の結果としてハイライトされ、その下に GitLab、Rules、Package Checker が表示されています。
  3. PyCharm に project に適用可能なプラグインがある場合、通知メッセージが表示されます。 通知メッセージのリンクをクリックして、提案されたプラグインをインストールまたは有効にします。

または、IDE 設定 (Ctrl+Alt+S) を開いて プラグイン​ を選択できます: プロジェクトに提案されたプラグインがある場合は、 推奨 セクションに表示されます。

カスタムプラグインリポジトリ

デフォルトでは、PyCharm は JetBrains Marketplace のプラグインを使用するように構成されています。 これは、誰もがプラグインをホストできるパブリックリポジトリです。 ただし、内部使用のみを目的としたプラグインを開発する場合は、そのプラグイン用にカスタムプラグインリポジトリをセットアップできます。

カスタムプラグインリポジトリの設定の詳細については、「IntelliJ プラットフォーム SDK ドキュメント(英語) 」を参照してください。

プラグインリポジトリを設定したら、それを PyCharm に追加します:

カスタムリポジトリを追加する

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

  2. プラグイン​ ページで、 設定ボタンリポジトリの管理、プロキシの構成、またはディスクからプラグインをインストール をクリックします。

    プラグインリポジトリの管理メニュー
  3. カスタムプラグインリポジトリ ダイアログで、 追加アイコン追加 をクリックし、リポジトリ URL を指定します。

    URL は、 プラグインを説明する XML ファイルの場所 (例: updatePlugins.xml ) を指している必要があります。 ファイルは、カスタムプラグインと同じサーバーに配置することも、専用のプラグインに配置することもできます。

    カスタムプラグインリポジトリを追加する方法
  4. カスタムプラグインリポジトリ ダイアログで OK をクリックしてプラグインリポジトリのリストを保存します。

  5. 設定 ダイアログで OK をクリックして変更を適用します。

プラグインを検索すると、PyCharm はデフォルトの JetBrains Marketplace と指定したカスタムリポジトリの両方から結果を表示します。 特定のカスタムプラグインリポジトリのみを閲覧するには、 プラグインの絞り込みプラグインの絞り込み をクリックし、 リポジトリ を選択してから、リストでこのリポジトリを選択します。

または、 idea.plugin.hosts プロパティを使用してカスタムプラグインリポジトリを追加することもできます。

  1. Help|カスタムプロパティの編集… に進みます。

  2. idea.plugin.hosts プロパティをプラットフォームプロパティファイルに追加し、 プラグインを説明する XML ファイル(英語)の URL を指定します。 例:

    idea.plugin.hosts="http://plugins.example.com:8080/updatePlugins.xml"
  3. PyCharm を再起動してください。

デフォルトの JetBrains マーケットプレイス(英語)をカスタムプラグインリポジトリに置き換えることができます。 これは、カスタムリポジトリプラグインのみを PyCharm から利用できるようにしたい場合に役立ちます。

デフォルトのプラグインリポジトリを置き換える

  1. Help|カスタムプロパティの編集… に進みます。

  2. プラットフォームのプロパティファイルに idea.plugins.host プロパティを追加し、PyCharm からのリクエストを正しく処理できるアプリケーションの URL を指定します。つまり、 JetBrains Marketplace の代わりにデフォルトのプラグインリポジトリアプリケーションとして動作する必要があります。

    特に、次の要求を処理する必要があります:

  3. PyCharm を再起動してください。

デフォルトのプラグインリポジトリを置き換えると、 プラグイン​ ダイアログの検索フィールドでは、新しいデフォルトリポジトリ内のプラグインと追加したカスタムリポジトリのみを閲覧します。

プラグインの更新ソースを手動で構成する

組織は、IDE プラグインディレクトリにプラグインを直接インストールまたは更新できます。 これにより標準のインストールプロセスがバイパスされるため、PyCharm は更新を確認する場所を認識できない場合があります。 ユーザーには更新ソースが見つからないことに関する警告が表示される場合があり、これらのプラグインは自動的に更新されません。

管理者は、 pluginUpdateSources.xml ファイルを編集してプラグインの更新ソースを構成できます。

  1. PyCharm の 構成ディレクトリを探して開きます。

  2. options フォルダーを開きます。

  3. pluginUpdateSources.xml ファイルを開くか作成します。

  4. 更新ソースを構成したいプラグインごとにエントリを追加します。

    <application> <component name="PluginUpdateSources"> <sources> <entry pluginId="pluginId"> <!-- For a custom repository --> <!-- The custom repository URL is exactly the URL of custom repository with trimmed `/` on the end, as it is configured in IDE --> <updateSource host="<custom repository url>" isMarketplace="false" /> </entry> <!-- Plugin2 will be updated from JetBrains Marketplace or Marketplace proxy for users of ToolBox Enterprise --> <entry pluginId="pluginId2"> <updateSource /> </entry> <entry pluginId="pluginId3"> <updateSource .../> </entry> ... </sources> </component> </application>

生産性のヒント

IDE と連携するウェブサイト、ドキュメントページ、チュートリアルなどには、IDE を開いてプラグインのインストールを促すリンクが含まれている場合があります。 インストールリンクをクリックすると:

  1. IDE が起動します。

  2. IDE がリクエストされたプラグインが利用可能かどうかを確認します。

  3. プラグインが互換性のある場合は、インストールまたは有効化を促されます。

  4. インストール後、プラグインはすぐに使用できます。 再起動が必要な場合は、IDE から案内があります。

    リンクに複数のプラグインが含まれている場合、まとめてインストールできます。

たとえば、このリンクを使って Mercurial プラグインをインストールできます。

2026 年 10 月 30 日