PyCharm 2026.1 Help

プラットフォームプロパティリファレンス

idea.properties ファイルには、IntelliJ プラットフォームに特有の設定とその他の関連するプロパティの両方を含めることができます。 プラットフォームプロパティを設定するには、 ヘルプ メニューで カスタムプロパティの編集​ をクリックします。

どのプロパティ名でもマクロを使用して、その値を挿入できます。例えば、 ${user.home} を使用すると、ユーザーのホームディレクトリを基準としたパスを指定できます。

プロパティ

デフォルト値

説明

idea.chooser.lookup.for.project.dirs

true

PyCharm が有効なプロジェクトを検索して、そのディレクトリを対応するアイコンでマークするかどうかを定義します。 このプロパティを無効にすると、そのようなルックアップはユーザーのホームディレクトリの外部では実行されません。

idea.cycle.buffer.size

1024

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

idea.dynamic.classpath

false

長いクラスパスをコマンドラインで渡すのではなく、ファイルに書き込み、そこから読み取るかどうかを定義します。 デフォルトでは無効になっており、コマンドがシェルで許可されている文字数の上限を超える場合、失敗します。

idea.max.content.load.filesize

20000

PyCharm がオープンして処理できるファイルの最大サイズ(キロバイト単位)を設定します。

idea.max.intellisense.filesize

2500

PyCharm がコーディング支援を提供するファイルの最大サイズ(キロバイト単位)を設定します。 大きなファイルのコーディング支援では、エディターのパフォーマンスが低下し、メモリ消費量が増加する可能性があります。

idea.max.vcs.loaded.size.kb

20480

変更の比較時に過去のファイル内容を表示するために PyCharm が読み込む最大サイズ(キロバイト単位)を設定します。

idea.no.launcher

false

PyCharm からプロセスを実行するときに特別なランチャーを使用するかどうかを定義します。 ランチャーはデフォルトで有効になっており、「ソフト終了」と「スレッドダンプ」機能を提供します。 これを無効にするには、 idea.no.launcher=true

idea.popup.weight

heavy

ウィンドウマネージャがマウス操作によるフォーカス変更とウィンドウの自動前面化を行う場合、このプロパティを medium に設定してください。これにより、一部の構成でポップアップメニューの問題を防げます。

idea.ProcessCanceledException

enabled

PyCharm でユーザー操作が検出された場合に ProcessCanceledException をスローするかどうか定義します。 これはプラグイン開発やIDE自体のデバッグ(バックグラウンドエラー解析スレッドで実行されるPSI関連の処理など)が必要な場合のみ無効にしてください。そうしないと、大きな遅延やフリーズの原因になります。

---

${idea.home} マクロ

${idea.home} マクロを使用して、IDE インストールホームに相対的な場所を指定します。

また、 ${xxx} は、その値を参照するために xxx が(このファイルの前の行で定義されたものを含む)任意の java プロパティです。

IDE の config フォルダーへのパス

IDE 設定フォルダーへのパスをカスタマイズする場合は、このオプションのコメントを外します。

idea.config.path=${user.home}/.PyCharm/config

IDE システムフォルダーへのパス

IDE システムフォルダーへのパスをカスタマイズする場合は、このオプションのコメントを外します。

idea.system.path=${user.home}/.PyCharm/system

ユーザーがインストールしたプラグインへのパス

ユーザーがインストールしたプラグインフォルダーへのパスをカスタマイズする場合は、このオプションのコメントを外します。

idea.plugins.path=${user.home}/.PyCharm/config/plugins

IDE ログフォルダーのパス

IDE ログフォルダーへのパスをカスタマイズする場合は、このオプションのコメントを外します。

idea.log.path=${user.home}/.PyCharm/system/log

最大ファイルサイズ

最大ファイルサイズ (キロバイト) IDE がコーディング支援を提供する必要があります。 ファイルが大きくなると、エディターの動作が遅くなり、コーディング支援が有効になっている場合は全体的なシステムメモリ要件が遅くなります。 https://youtrack.jetbrains.com/issue/IDEA-72543

ファイルのサイズに関係なく、ファイルを使用できるようにコーディング支援が必要な場合は、このプロパティを削除するか、非常に大きな数値に設定します。

idea.max.intellisense.filesize=2500

ファイルサイズの上限

IDE がロードできる最大ファイルサイズ。 例: 「ファイル内検索」アクションで指定された制限を超えるファイルがある場合、IDE はそのようなファイルを無視します。 サイズ制限を手動で指定することで、デフォルトの最大サイズをオーバーライドできます。

idea.max.content.load.filesize=2000

コンソール循環バッファ

このオプションはコンソールの循環バッファを制御し、出力サイズが指定したバッファサイズ(KB)を超えないようにします。 古い行は削除されます。 循環バッファを無効化するには、 idea.cycle.buffer.size=disabled を使用してください

idea.cycle.buffer.size=1024

ランチャー

IDE 内からプロセスを実行するときに特別なランチャを使用するかどうかを設定します。 Launcher を使用すると、「ソフト終了」と「スレッドダンプ」機能が有効になります。

idea.no.launcher=false

クラスパス

クラスパスが長すぎるのを避けるには

idea.dynamic.classpath=false

ProcessCanceledException

ユーザーアクティビティが検出されたときに IDE が ProcessCanceledException をスローしないようにするには、このプロパティのコメントを外します。 このオプションは、バックグラウンドエラー解析スレッドで実行される PSI 関連のアクティビティをデバッグする際にのみ、プラグイン開発者にとって有用です。

独自が開発している IDE を使用していない限り、このことを認めないでください。 それ以外の場合、大幅な減速やロックアップが発生します。

idea.ProcessCanceledException=disabled

ポップアップウィンドウの重さ

idea.popup.weight プロパティには "heavy" と "medium" の 2 つの値があります。 WM が "Auto Raise でマウスに追従する " として WM を設定している場合、このプロパティを "medium" に設定する必要があります。 いくつかの設定でポップアップメニューの問題を防ぎます。

idea.popup.weight=heavy

システムアンチエイリアス

システムのデフォルトアンチエイリアスを使用します。これは「設定|エディター|外観|アンチエイリアスフォントを使用」オプションの値をオーバーライドします。 たとえば Windows Remote Desktop Connection を使用している場合に役立つことがあります。

idea.use.default.antialiasing.in.editor=false

再描画

このプロパティを無効にすると、点滅などの視覚的な不具合が発生し、特定のディスプレイアダプターカードで再描画できなくなります。

sun.java2d.noddraw=true

エディターのパフォーマンス

このプロパティを削除すると、Windows ではエディターのパフォーマンスが低下する可能性があります。

sun.java2d.d3d=false

スロースクロール

JDK6 でのスロースクロールの回避策

swing.bufferPerWindow=false

X Window でのエディターのパフォーマンス

このプロパティを削除すると、X Window でエディターのパフォーマンスが低下する可能性があります。

sun.java2d.pmoffscreen=false

長いハングを避ける

macOS でクリップボードにアクセスしている間、長いハングを避けるための回避策。

ide.mac.useNativeClipboard=True

ライブラリの jar をコピーする

IDE はライブラリジャーをコピーしてロックを防ぎます。 コピーが望ましくない場合は、"true"

idea.jars.nocopy=false

デバッグモードで JVM を起動する

デバッグモードで JVM を起動するために使用される VM オプション値。 いくつかの JRE はそれを異なる方法で定義しています (Oracle VM の -XXdebug)

idea.xdebug.key=-Xdebug

JMX 1.0 互換モードに切り替えます。

1.4 を実行しているアプリケーションサーバー(WebLogic など)を操作しているときに、J2SDK 1.5 以上を使用して PyCharm を実行できるようにするには、このオプションのコメントを解除します。

jmx.serial.form=1.0

致命的なエラー通知

インストールされている IDE またはプラグインで発生する致命的なエラーに関する瞬時のビジュアル通知を受け取る場合は、'enabled' に変更します。

idea.fatal.error.notification=disabled
2026 年 6 月 1 日