PyCharm 2020.2ヘルプ

高度な構成

使用可能な標準オプションに加えて、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オプションを構成する

次のいずれかを実行して、元のファイルをオーバーライドする構成ディレクトリに、JVMオプションを含むデフォルトファイルのコピーを作成します。

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

  • プロジェクトが開いていない場合は、ようこそ画面で構成をクリックしてからカスタム VM オプションの編集をクリックします。

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

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

共通オプション

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

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

プラットフォームのプロパティを構成します。

次のいずれかを実行して、構成ディレクトリに空のidea.propertiesファイルを作成し、元のファイルの値を上書きします。

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

  • 開いているプロジェクトがない場合は、ようこそ画面で構成をクリックしてからカスタム・プロパティの編集を選択します。

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

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

共通プロパティ

ユーザーは次のプロパティを頻繁に変更します。

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

    プロパティへのパス
    idea.config.path構成ディレクトリ
    idea.system.pathシステムディレクトリ
    idea.plugins.pathプラグインディレクトリ
    idea.log.pathログディレクトリ

    Windowsパス(/など)を含む、スラッシュC:/idea/systemを使用してパスを指定します。

    プロパティを変数として挿入できます。例: ${user.home} (標準Javaシステムプロパティ)を使用して、ユーザーのホームディレクトリからの相対パスを指定します。

    idea.config.path=${user.home}/MyIdeaConfiguration
  • パフォーマンスに影響を与える可能性のある制限:

    プロパティ説明
    idea.max.content.load.filesizePyCharmが開くことができるファイルの最大サイズ(キロバイト)。大きなファイルを扱うと、エディターのパフォーマンスが低下し、メモリ消費量が増加する可能性があります。デフォルト値は 20000です。
    idea.max.intellisense.filesizePyCharmがコーディング支援を提供するファイルの最大サイズ(キロバイト単位)。大きなファイルに対するコーディング支援は、エディターのパフォーマンスに影響を与え、メモリ消費量を増やす可能性があります。デフォルト値は 2500です。
    idea.cycle.bufferコンソール巡回バッファの最大サイズ(キロバイト単位)。コンソール出力サイズがこの値を超えると、最も古い行が削除されます。サイクリックバッファを無効にするには、idea.cycle.buffer.size=disabledを設定します。
    idea.max.vcs.loaded.size.kb変更を比較するときに過去のファイルの内容を表示するためにPyCharmがロードする最大サイズ(キロバイト)。デフォルト値は 20480です。

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

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

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

構成ディレクトリ

PyCharm構成ディレクトリには、キーマップ、カラースキーム、カスタムVM オプションプラットフォームプロパティなどのユーザー定義のIDE設定が含まれています。

構文
%APPDATA%\JetBrains\<product><version>
サンプル
C:\Users\JohnS\AppData\Roaming\JetBrains\PyCharm2020.2
構文
~/Library/Application Support/JetBrains/<product><version>
サンプル
~/Library/Application Support/JetBrains/PyCharm2020.2
構文
~/.config/JetBrains/<product><version>
サンプル
~/.config/JetBrains/PyCharm2020.2

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

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

システムディレクトリ

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

構文
%LOCALAPPDATA%\JetBrains\<product><version>
サンプル
C:\Users\JohnS\AppData\Local\JetBrains\PyCharm2020.2
構文
~/Library/Caches/JetBrains/<product><version>
サンプル
~/Library/Caches/JetBrains/PyCharm2020.2
構文
~/.cache/JetBrains/<product><version>
サンプル
~/.cache/JetBrains/PyCharm2020.2

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

プラグインディレクトリ

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

構文
%APPDATA%\JetBrains\<product><version>\plugins
サンプル
C:\Users\JohnS\AppData\Roaming\JetBrains\PyCharm2020.2\plugins
構文
~/Library/Application Support/JetBrains/<product><version>/plugins
サンプル
~/Library/Application Support/JetBrains/PyCharm2020.2/plugins
構文
~/.local/share/JetBrains/<product><version>
サンプル
~/.local/share/JetBrains/PyCharm2020.2

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

ログディレクトリ

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

構文
%LOCALAPPDATA%\JetBrains\<product><version>\log
サンプル
C:\Users\JohnS\AppData\Local\JetBrains\PyCharm2020.2\log
構文
~/Library/Logs/JetBrains/<product><version>
サンプル
~/Library/Logs/JetBrains/PyCharm2020.2
構文
~/.cache/JetBrains/<product><version>/log
サンプル
~/.cache/JetBrains/PyCharm2020.2/log

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

最終更新日: 2020年7月28日