PyCharm 2019.3ヘルプ

高度な構成

設定/環境設定ダイアログ Ctrl+Alt+Sで使用可能な標準オプションに加えて、PyCharmを使用すると、基礎となるプラットフォームおよびJavaランタイムの低レベルの構成を実行できます。

JVMオプションの設定

PyCharmは、JVM(Java Virtual Machine)上で動作します。JVMには、パフォーマンスを制御するさまざまなオプションがあります。PyCharmの実行に使用されるデフォルトのオプションは、次のファイルで指定されています。

<IDE_HOME>\bin\pycharm64.exe.vmoptions (デフォルトの64ビットJVMの場合)

<IDE_HOME>\bin\pycharm.exe.vmoptions (オプションの32ビットJVM用)

PyCharm.app/Contents/bin/pycharm.vmoptions

<IDE_HOME>/bin/pycharm64.vmoptions (デフォルトの64ビットJVMの場合)

<IDE_HOME>/bin/pycharm.vmoptions (オプションの32ビットJVM用)

JVMオプションを設定するには:

  • ヘルプメニューで、カスタム VM オプションの編集をクリックします。

  • ようこそ画面で、構成をクリックしてからカスタム VM オプションの編集をクリックします。

  • PyCharmを起動できない場合は、JVMオプションを含むデフォルトファイルを手動でPyCharm構成ディレクトリーにコピーできます。

PyCharmは、構成ディレクトリー内にJVMオプション付きのファイルのコピーを作成し、それを新しいエディタータブで開きます。このファイルで変更した値は、元のデフォルトファイルの値を上書きします。

PyCharm構成ディレクトリーへの書き込みアクセス権がない場合は、PYCHARM_VM_OPTIONS 環境変数を追加して、JVMオプションを使用してファイルの場所を指定できます。このファイルの値は、元のデフォルトファイルと、PyCharm構成ディレクトリーにあるコピーの両方の対応する値を上書きします。

共通オプション

ほとんどの場合、JVMオプションはデフォルト値が最適です。以下は一般的によく変更されるものです。

オプション

説明

-Xmx

JVMがPyCharmを実行するために割り当てることができる最大メモリヒープサイズを制限します。デフォルト値はプラットフォームによって異なります。速度が低下している場合は、この値を増やしたい場合があります。たとえば、値を2048メガバイトに設定するには、このオプションを -Xmx2048mに変更します。

-Xms

PyCharmを実行するためにJVMによって割り当てられた初期メモリを指定します。デフォルト値はプラットフォームによって異なります。通常、最大許容メモリ(-Xmx)の約半分に設定されます( -Xms1024mなど)。

-XX:NewRatio

若い世代と古い世代のヒープのサイズの比を指定します。ほとんどの場合、2と4の間の比率が推奨されます。これは若い世代のサイズをそれに対応して旧世代の1/2〜1/4に設定します。これは、1つのプロジェクトで頻繁に作業し、一度に少数のファイルで作業する場合に適しています。ただし、常に新しいファイルを開き、いくつかのプロジェクトを切り替える場合は、若い世代を増やす必要があります。この場合、-XX:NewRatio=1を設定してみてください。これは、若い世代を古い世代ほど大きくし、オブジェクトを若い世代に長く留めさせるものです。

使用可能なJVMオプションの詳細については、WindowsまたはmacOS / Linuxjava リファレンスを参照してください。

プラットフォームプロパティーの設定

PyCharmでは、ユーザーがインストールしたプラグインへのパスやサポートされる最大ファイルサイズなど、さまざまなプラットフォーム固有のプロパティーをカスタマイズできます。PyCharmの実行に使用されるデフォルトのプロパティーは、次のファイルで指定されます。

<IDE_HOME>\bin\idea.properties

PyCharm.app/Contents/bin/idea.properties

<IDE_HOME>/bin/idea.properties

プラットフォームのプロパティーを設定するには:

  • ヘルプメニューからカスタム・プロパティーの編集を選択します。

  • ようこそ画面で、構成をクリックしてからカスタム・プロパティーの編集を選択します。

  • PyCharmを起動できない場合は、空の idea.properties ファイルをPyCharm構成ディレクトリーに手動で作成します。

PyCharmは構成ディレクトリーに空の idea.properties ファイルを作成し、新しいエディタータブで開きます。このファイルに追加したプロパティーは、元のデフォルトファイルの対応するプロパティーを上書きします。

PyCharm構成ディレクトリーへの書き込み権限がない場合は、PYCHARM_PROPERTIES 環境変数を追加して idea.properties ファイルの場所を指定できます。このファイルのプロパティーは、元のデフォルトファイルとPyCharm構成ディレクトリーにあるデフォルトファイルの両方の対応するプロパティーを上書きします。

共通プロパティー

以下のプロパティーは、特定の課題を解決するユーザによって一般的に変更されます。

  • ホームディレクトリーが暗号化されている(IDEの速度が低下している)場合や、ネットワークドライブ上にある場合など、デフォルトのIDEディレクトリーの場所を移動する必要がある場合があります(たとえば、ユーザープロファイルドライブの領域が不足しているか、ポータブルインストールを作成したり、ホームディレクトリーのバックアップからキャッシュを除外したりする場合などです。

    任意のプロパティー名を持つマクロを使用して値を挿入することができます。たとえば、${user.home} (標準Javaシステムプロパティー)を使用して、ユーザーのホームディレクトリーに対する相対パスを指定します。

    プロパティー

    へのパス

    idea.config.path構成ディレクトリー
    idea.system.pathシステムディレクトリー
    idea.plugins.pathプラグインディレクトリー
    idea.log.pathログディレクトリー
  • パフォーマンスに影響を与える可能性のある制限:

    プロパティー

    説明

    idea.max.content.load.filesize

    PyCharmが開くことができるファイルの最大サイズ(キロバイト)。大きなファイルを扱うと、エディターのパフォーマンスが低下し、メモリ消費量が増加する可能性があります。デフォルト値は 20000です。

    idea.max.intellisense.filesize

    PyCharmがコーディング支援を提供するファイルの最大サイズ(キロバイト単位)。大きなファイルに対するコーディング支援は、エディターのパフォーマンスに影響を与え、メモリ消費量を増やす可能性があります。デフォルト値は 2500です。

    idea.cycle.buffer

    コンソール巡回バッファの最大サイズ(キロバイト単位)。コンソール出力サイズがこの値を超えると、最も古い行が削除されます。サイクリックバッファを無効にするには、idea.cycle.buffer.size=disabledを設定します。

    idea.max.vcs.loaded.size.kb

    変更を比較するときにPyCharmが過去のファイル内容を表示するためにロードする最大サイズ(キロバイト)。デフォルト値は 20480です。

PyCharmは、環境(ウィンドウマネージャー、ランチャ、ファイルシステムなど)とのやりとりを定義する多数のその他のプロパティーを提供します。それらのほとんどは、明らかに公開されていないという意味では隠された設定のようなもため、場合によっては有効または無効にする必要があります。これらのプロパティーは、JetBrainsのサポート(英語)に連絡してから変更することを強くお勧めします。

デフォルトのIDEディレクトリー

デフォルトでは、PyCharmは、ユーザー固有のファイル(構成、キャッシュ、プラグイン、ログなど)をユーザーのホームディレクトリーに格納します。ただし、必要に応じて、これらのファイルを保存する場所を変更できます。

構成ディレクトリー

PyCharm構成ディレクトリーには、キーマップ、配色などの個人設定を含むXMLファイルが含まれています。これは、ユーザー定義のVM オプションおよびプラットフォームプロパティーファイルのデフォルトの場所でもあります。

構文
%HOMEPATH%\.<product><version>\config
サンプル
C:\Users\JohnS\.PyCharm2019.3\config
構文
~/Library/Preferences/<product><version>
サンプル
~/Library/Preferences/PyCharm2019.3
構文
~/.<product><version>/config
サンプル
~/.PyCharm2019.3/config

idea.config.pathプロパティーを使用して、PyCharm構成ディレクトリーの場所を変更することができます。

構成ディレクトリーから別のPyCharmインストールの対応するフォルダーにファイルをコピーすることで、個人用のIDE設定を共有できます。PyCharmが実行されていないことを確認して、IDEをシャットダウンするときにコピーしたファイルを消去しないようにしてください。

システムディレクトリー

PyCharmシステムディレクトリーには、キャッシュとローカル・ヒストリーファイルが含まれています。

構文
%HOMEPATH%\.<product><version>\system
サンプル
C:\Users\JohnS\.PyCharm2019.3\system
構文
~/Library/Caches/<product><version>
サンプル
~/Library/Caches/PyCharm2019.3
構文
~/.<product><version>/system
サンプル
~/.PyCharm2019.3/system

idea.system.pathプロパティーを使用して、PyCharmシステムディレクトリーの場所を変更することができます。

プラグインディレクトリー

PyCharm pluginsディレクトリーには、ユーザがインストールしたプラグインが含まれています。

構文
%HOMEPATH%\.<product><version>\config\plugins
サンプル
C:\Users\JohnS\.PyCharm2019.3\config\plugins
構文
~/Library/Application Support/<product><version>
サンプル
~/Library/Application Support/PyCharm2019.3
構文
~/.<product><version>/config/plugins
サンプル
~/.PyCharm2019.3/config/plugins

idea.plugins.pathプロパティーを使用して、PyCharmプラグインディレクトリーの場所を変更することができます。

ログディレクトリー

PyCharmログディレクトリーには、製品ログとスレッドダンプが含まれています。

構文
%HOMEPATH%\.<product><version>\system\log
サンプル
C:\Users\JohnS\.PyCharm2019.3\system\log
構文
~/Library/Logs/<product><version>
サンプル
~/Library/Logs/PyCharm2019.3
構文
~/.<product><version>/system/log
サンプル
~/.PyCharm2019.3/system/log

idea.log.pathプロパティーを使用して、PyCharmログディレクトリーの場所を変更することができます。

最終更新日: 2019年12月5日