PyCharm 2026.1 Help

アップロードとダウンロードをカスタマイズする

さまざまなプロジェクト(サーバーのセットアップ)でのアップロードとダウンロードを確実に成功させるための必須設定の他に、サーバーとの対話をカスタマイズするための追加オプションを構成できます。 これらのオプションのほとんどは、すべての サーバーアクセス構成タイプに適用されます。 FTP、FTPS、SFTP サーバー構成の場合、追加のプロトコル固有のオプションを指定できます。

一般的なアップロードとダウンロードのオプションを設定する

  1. Ctrl+Alt+S を押して設定を開き、 ビルド、実行、デプロイ | デプロイ | オプション を選択します。

    または、メインメニューの ツール|デプロイ|オプション… に移動します。

  2. 追加設定を指定してください:

    • アップロードおよびダウンロード中に特定のファイルまたはフォルダー全体をスキップするには、 項目を名前で除外する フィールドで、これらのファイルとフォルダーの名前を定義するパターンを指定します。

      セミコロン ; を区切り文字として使用し、アスタリスク * をゼロ以上の文字に一致させ、疑問符 ? を単一の文字に一致させます。

      例: 3 つのファイル style.css style1.css style2.scss を持つフォルダー stylesheets がある場合、 style* はフォルダー全体を除外し、 style?.css style1.css を除外し、 style?.* style1.css style2.scss を除外します。

      正規表現 .info(英語) の詳細を参照してください。

      除外は再帰的に適用されます。 つまり、一致するフォルダーにサブフォルダーがある場合、これらのサブフォルダーの内容はデプロイされません。

      詳細については、 アップロードとダウンロードからファイルとフォルダーを除外する を参照してください。

    • アップロードおよびダウンロード手順の詳細を指定するには、対応するチェックボックスをオンまたはオフにします。

追加のプロトコル固有のカスタマイズオプションを指定する

  1. Ctrl+Alt+S を押して設定を開き、 ビルド、実行、デプロイ | デプロイ を選択します。

    または、メインメニューの ツール | デプロイ | 構成 に移動します。

  2. 構成済みのサーバーを選択し、 接続 タブの 詳細グループをデプロイして、プロトコルに応じた追加のアップロード設定を指定します。

    • Number of connections フィールドで、同時にサポートされる接続の最大数を指定します。

    • Send keep-alive messages each フィールドで、PyCharm がサーバーにコマンドを送信してタイムアウトをリセットし、接続を維持する頻度を指定します。

    • Encoding for client-server communication フィールドに、サーバーで使用されているエンコーディングと一致するエンコーディングを指定します。 UTF-8 エンコーディングがサポートされているかどうかわからない場合は、デフォルト値をそのまま使用してください。

    • クライアントを パッシブモード(英語)に設定するには、 Passive mode チェックボックスを選択します。 このモードでは、マシンのクライアントがサーバーに接続してパッシブモードであることを通知し、リッスンするポート番号を受信し、受信した番号のポートを介してデータ接続を確立します。 このモードは、マシンがファイアウォールの背後にある場合に役立ちます。

    • サーバーブラウザーツールウィンドウに非表示のファイルとディレクトリ(ドット . で始まる名前)を表示するには、 Show and process hidden files を選択します。

    • LIST コマンドを使用する 領域で Compatible with old version of listing children を選択して、FTP サーバーとの 子ファイルの命名の互換性(英語)を確保します。

      このオプションは、リモート FTP サーバーが次のエラーを報告する場合に役立ちます:

      Invalid descendant file name <file name>

      このオプションを選択すると、サーバーとの同期が遅くなる可能性があります。

    • MLSD コマンドの代わりに一覧表示するための標準 LIST コマンドを使用する LIST コマンドを使用する エリアで Instead of MLSD を選択します。 たとえば、FTP サーバーが MLSD をサポートし、 cdir を返す場合、アップロード中に 下位ファイル名が無効です という例外が発生するなどの問題を回避できます。

    • Number of connections フィールドで、同時にサポートされる接続の最大数を指定します。

    • Send keep-alive messages each フィールドで、PyCharm がサーバーにコマンドを送信してタイムアウトをリセットし、接続を維持する頻度を指定します。

    • Keep-alive command リストから、サーバーに送信するコマンドを選択してタイムアウトをリセットし、接続を維持します。

    • TLS: Transfer Layer Security の方法。 プレーン(非セキュア)モードと同じポートを使用するには Explicit を選択し、専用ポートを使用するには 暗黙的 を選択します。

    • Data channel protection level: 非セキュア接続の場合は クリア を選択し、セキュア接続の場合は 非公開 を選択します。

    • Reuse SSL session: SSL 接続中に確立された、キーとアルゴリズムの合意情報を含むセキュリティ契約の再利用を選択します。

    • Disable TLS 1.3 :TLS 1.3 機能を無効化し、PyCharm を TLS 1.2 で接続するようにフォールバックさせる場合に選択します。 サーバーへの接続の確立または特定のファイルのアップロードで問題が発生した場合は、このオプションを使用してください。

    • クライアントを パッシブモード(英語)に設定するには、 Passive mode チェックボックスを選択します。 このモードでは、マシンのクライアントがサーバーに接続してパッシブモードであることを通知し、リッスンするポート番号を受信し、受信した番号のポートを介してデータ接続を確立します。 このモードは、マシンがファイアウォールの背後にある場合に役立ちます。

    • サーバーブラウザーツールウィンドウに非表示のファイルとディレクトリ(ドット . で始まる名前)を表示するには、 Show and process hidden files を選択します。

    • LIST コマンドを使用する 領域で Compatible with old version of listing children を選択して、FTP サーバーとの 子ファイルの命名の互換性(英語)を確保します。

      このオプションは、リモート FTP サーバーが次のエラーを報告する場合に役立ちます:

      Invalid descendant file name <file name>

      このオプションを選択すると、サーバーとの同期が遅くなる可能性があります。

    • MLSD コマンドの代わりに一覧表示するための標準 LIST コマンドを使用する LIST コマンドを使用する エリアで Instead of MLSD を選択します。 たとえば、FTP サーバーが MLSD をサポートし、 cdir を返す場合、アップロード中に 下位ファイル名が無効です という例外が発生するなどの問題を回避できます。

2026 年 6 月 1 日