PyCharm 2024.1 ヘルプ

詳細な構成

IDE 設定で使用できる標準オプションに加えて、PyCharm を使用すると、基盤となるプラットフォームと Java ランタイムの低レベルの構成を実行できます。

JVM オプション

PyCharm は、パフォーマンスを制御するさまざまなオプションを備えた Java 仮想マシン (JVM) 上で実行されます。

PyCharm の実行に使用されるデフォルトのオプションは、IDE インストールディレクトリで指定されます。

<IDE_HOME>\bin\pycharm64.exe.vmoptions

PyCharm.app/Contents/bin/pycharm.vmoptions

<IDE_HOME>/bin/pycharm64.vmoptions

JVM オプションを構成する

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

  • メインメニューで、ヘルプ | カスタム VM オプションの編集に移動します。

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

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

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

JVM オプションファイルを見つける

PyCharm が JVM オプションを取得している場所がわからない場合は、以下を確認してください。

  1. PYCHARM_VM_OPTIONS 環境変数で指定された場所。指定されたファイルが存在する場合、他のすべての JVM オプションファイルを上書きします。

  2. Toolbox アプリが現在の PyCharm インスタンスを管理している場合は、Toolbox アプリを開き、関連する IDE インスタンスの横にある The screw nut icon をクリックして、設定を選択します。構成Java Virtual Machine のオプションを見つけ、編集をクリックします。

  3. スタンドアロンの PyCharm インスタンスを実行している場合は、構成ディレクトリを確認してください。

  4. 以前の場所で定義された JVM オプションファイルがない場合、PyCharm はデフォルトの JVM オプションファイルを使用します。変更しないでください。PyCharm が使用するデフォルトオプションを確認するためにのみ使用してください。

共通オプション

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

-Xmx

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

詳細は、IDE のメモリヒープを増やすを参照してください。

-Xms

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

-XX:NewRatio

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

詳しくは、Java ガベージコレクションの基本(英語)を参照してください。

各オプションを別の行に指定します。JVM オプションファイルの例:

-Xmx4G -Xms2G -XX:NewRatio=4

使用可能な JVM オプションの詳細については、java(英語) コマンドリファレンスを参照してください。

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

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

<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.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 です。

各プロパティを別の行に指定します。プラットフォームプロパティファイルの例:

idea.max.intellisense.filesize=5000 idea.cycle.buffer.size=1024

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

関連ページ:

IDE で使用されるディレクトリ

デフォルトでは、PyCharm は、各 IDE インスタンスのユーザー固有のファイル(構成、キャッシュ、プラグイン、ログなど)をユーザーのホームディレクトリに保存します。ただし、必要に応じて、これらのファイルを保存する場所を変更できます。IDE ディレクトリの場所を変更するたとえば、ユーザープロファイルドライブの容量が不足している場合や低速ディスクにある場合、ホームディレクトリが暗号化されている(IDE の速度が低下している)場合、またはネットワークドライブにある場合は、デフォルトの IDE デ...

IDE のメモリヒープを増やす

PyCharm を実行している Java 仮想マシン(JVM)は、事前定義された量のメモリを割り当てます。デフォルト値はプラットフォームによって異なります。速度が低下している場合は、メモリヒープを増やすことをお勧めします。メインメニューで、に移動します。割り当てる必要なメモリ量を設定し、保存して再起動をクリックします。このアクションは、JVM が PyCharm を実行するために使用するオプションの値を変更します。新しい設定を有効にするには、PyCharm を再起動します。PyCharm は、ガ...

ファイル、フォルダー、テキストソースを比較する

PyCharm を使用すると、ファイル、フォルダー、テキストソース、データベースオブジェクト間の違い、ローカルファイルとそれらのリポジトリバージョン間の違いを確認できます。ファイルを比較:PyCharm はファイルの差分ビューアーに差分を表示します: グリーン追加済みブルー変更グレー削除変更を適用するには、シェブロンボタン (および) を使用します。変更を追加するには、を押します。ボタンは

コード品質支援のヒントとコツ、またはコードをきれいに見せる方法

このチュートリアルの内容:このチュートリアルでは、PyCharm のコードインテリジェンス機能を使用して、Python プロジェクトでソースコードを作成する手順を順を追って説明します。PyCharm はソースコードを適切なインデント、スペース、インポートなどで完璧な形に保つのに役立ちます。実際、PyCharm 自体がコード品質ツールであることがわかります。Python プログラミングはこのチュートリアルの範囲外です。Python 言語の詳細については、公式 Web サイトを参照してください。始...