PyCharm 2026.1 Help

外部ツール

サードパーティのコマンドラインアプリケーションを外部ツールとして構成し、PyCharm から実行します。

たとえば、ワークフローによっては、特定のスクリプト、コードジェネレーター、アナライザー、プリプロセッサやポストプロセッサ、データベースユーティリティなどの実行が必要な場合があります。 それを外部ツールとして構成すると、PyCharm は専用のアクションを提供し、メインメニューや特定のコンテキストメニューから実行したり、ショートカットを割り当てたり、特定の実行構成の開始時に実行できます。

組み込み IDE マクロを使用して、現在のファイルやプロジェクトソースパスなど、コンテキスト依存のコマンドライン引数をツールに渡すことができます。 必要に応じて、PyCharm はツールの出力をコンソールに出力します。

PyCharm は、次のタイプの外部ツールをサポートしています:

  • ローカルツールは、コンピューター上でローカルに実行されます。

  • リモートツールは SSH を介してリモートサーバー上で実行されます。

ローカル外部ツールを追加する

pylint は、コードをチェックし、スタイル、ロジック、使用上の問題を検出するコードアナライザーツールです。 これは、PyCharm で利用可能なコード検証機能への素晴らしい追加かもしれません。

  1. メインメニューで、 表示 | ツールウィンドウ | Python パッケージ に移動して、 Python パッケージツールウィンドウを開きます。

  2. 検索フィールドで「pylint」を検索し、パッケージの一覧から選択します。

  3. パッケージ名の横にある インストールする をクリックし、バージョンを選択します。

    pylint のインストール
  4. システムに pylint をインストールしたため、PyCharm との統合を設定できます。

  5. Ctrl+Alt+S を押して設定を開き、 ツール | 外部ツール を選択します。

  6. 新しい外部ツールを追加するには、 add an external tool ボタンをクリックします。

  7. 次のように設定オプションを追加します。

    外部ツールとして pylint を設定する
    • グループ: ツール | 外部ツール メニューに表示する外部ツールグループの名前

    • 名前: 外部ツール名

    • 説明: オプションの説明

    • プログラム: pylint 実行可能ファイルへのパス($PyInterpreterDirectory$ は、現在のプロジェクトの Python インタープリターが配置されるディレクトリです)。 例:

      $PyInterpreterDirectory$\pylint

      $PyInterpreterDirectory$/pylint (Linux, macOS)

    • 引数: チェックするファイルとフォルダー(この例では car .py test )を指定し、pylint エラーの出力形式を設定します。 例:

      --msg-template="$FileDir$\{path}:{line}:{column}:{C}:({symbol}){msg}" car.py test

      --msg-template="$FileDir$/{path}:{line}:{column}:{C}:({symbol}){msg}" car.py test

    • 作業ディレクトリ: プロジェクトルートディレクトリ

    • 拡張オプション セクションのすべてのオプションを有効にして、エラーのあるファイルへのリンクを pylint 出力に挿入するように 出力フィルター を設定すると、コード内のエラーや警告にすばやく移動できます。

  8. 変更を保存するには、 OK をクリックします。 外部ツール ウィンドウで 適用OK をクリックして外部ツールを追加します。

これで ツール | 外部ツール からこの外部ツールにアクセスできます。

Pylint は外部ツールメニューに表示されます

このメニューを使用して pylint を実行できます。 ただし、アプリケーションの 実行 / デバッグ構成に追加することもできます。

外部ツールを実行する

  1. 実行 | 実行構成の編集 ... に進みます。

  2. 実行 / デバッグ構成 ダイアログで、 オプションを変更 リンクをクリックし、 起動前タスクの追加 を選択します。

    起動前タスクの追加
  3. 新規タスクの追加 リストから 外部ツールの実行 を選択してください。

    起動前のタスクの追加
  4. 外部ツール ダイアログで、 pylint を選択し、 OK をクリックします。 Pylint はアプリケーション起動前に実行されるスクリプト一覧に追加されます。

    起動前のタスクの追加
  5. 実行 / デバッグ構成 ダイアログに戻り、もう一度 OK をクリックして変更を保存します。

  6. Shift+F10 ショートカットまたは 実行 ボタンを使用して構成を実行します。

    スクリプトを実行すると、 実行 ツールウィンドウの pylint タブに出力が表示されます。

    Pylint によるコード検証

報告されたエラーをインスペクションし、対応するリンクをクリックして問題のあるコードに移動し、必要な変更を加えることができます。

リモート外部ツールを追加する

リモート SSH 外部ツールはローカルの外部ツールと同様に設定しますが、それらが実行されるリモートサーバーを定義し、SSH 経由で接続するための認証情報が必要です。

この例では、SSH を介してリモートサーバーで実行され、現在の日付と時刻を返すリモート SSH 外部ツールとして date を追加する方法を示します。

  1. Ctrl+Alt+S を押して設定を開き、 ツール | リモート SSH 外部ツール を選択します。

  2. 追加ボタン をクリックして ツールの作成 ダイアログを開きます。

    リモート外部ツールの追加

    このダイアログでは、 ローカル外部ツールを追加するときと同じ設定セットが提供されますが、リモート接続を選択することもできます。 接続設定を指定しない場合、PyCharm はサーバー上でツールを実行するたびに、ホスト、ポート、関連する SSH 資格情報を要求します。 詳細については、 リモート SSH 外部ツール を参照してください。

  3. OK をクリックしてツールを追加し、変更を適用します。

追加されたツールをリモートサーバーで実行する

次のいずれかを実行します:

  • メインメニューで、 Tools | Remote Tools と追加されたリモート外部ツールの名前に移動します。

  • ツールを実行するためのショートカットを作成します。

    Ctrl+Alt+S を押して設定を開き、 キーマップ を選択します。 設定したリモート外部ツールの名前のアクションを見つけて、ショートカットを割り当てます。

ホスト、ポート、資格情報を指定した後、PyCharm は SSH 経由でサーバーに接続して date コマンドを実行し、PyCharm の 実行 ツールウィンドウに出力を返します。

ウェブブラウザー

Web ブラウザーを使用して、プロジェクトから任意のファイルを開くことができます。 デフォルトでは、HTML ファイルの出力をプレビューしたり、Web アプリケーションを実行およびデバッグしたりするために使用されます。

Web ブラウザーでファイルを開く

Web ブラウザー(HTML、XML、JSP など)でレンダリングされることを想定したファイルを開くには、次のいずれかを実行してください:

  • ファイルをエディターで開き、 Alt+F2 を押します。

  • Project tool window 内のファイルを右クリックし、 ブラウザーで開く を選択します。

  • メインメニューで 表示 | ブラウザーで開く へ移動します。

  • エディターウィンドウの右上部分にあるブラウザーポップアップ (マウスを置くと表示されます) を使用します。 ブラウザーボタンをクリックして Web サーバーファイル URL を開くか、 Shift+Click をクリックして ローカルファイル URL を開きます。

    エディターのブラウザーポップアップ

ブラウザーで開く アクションは、他のファイルタイプでは使用できません。 ただし、 アクションの検索 Ctrl+Shift+A を使用して実行することはできます。

ブラウザーのリストを表示および構成する

  • 設定 ダイアログ(Ctrl+Alt+S )で、 ツール | ウェブブラウザーとプレビュー を選択します。

設定の Web ブラウザーページ

標準の手順を使用してブラウザーをインストールした場合は、 パス フィールドのエイリアスが正しい場所を指しているはずです。 そうでない場合は、対応する実行可能ファイルへのパスを指定します。

カスタムプロファイルと設定を使用する

Firefox および Chrome ファミリーブラウザー用のカスタムプロファイルを設定できます。

  1. 設定 ダイアログ(Ctrl+Alt+S )で、 ツール | ウェブブラウザーとプレビュー を選択します。

  2. リストからブラウザーを選択して 編集ボタン をクリックします。

    • Firefox の場合は、 profiles.ini ファイルへのパスを指定し、使用するプロファイルを選択します。 詳細については、 Firefox のブラウザープロファイル(英語)を参照してください。

    • Chrome の場合は カスタムユーザーデータディレクトリを使用する を選択し、 ユーザーデータディレクトリ(英語)の場所を指定します。

      PyCharm から Chrome を実行するときに使用する追加のコマンドラインオプションを指定することもできます。 詳細については、Chrome アドレスバーの chrome://flags を開いてください。

2026 年 6 月 1 日