高级配置

除 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 选项。
如果无法启动 PyCharm，请将默认 JVM 选项文件手动复制到 PyCharm 的配置目录。

如果您没有 PyCharm 配置目录的写入权限，您可以添加 PYCHARM_VM_OPTIONS 环境变量，以指定包含您首选 JVM 选项的文件的位置。此文件将同时覆盖原始默认文件以及位于 PyCharm 配置目录中的副本。

定位 JVM 选项文件

如果您不确定 PyCharm 从何处获取其 JVM 选项，请检查以下内容：

由 PYCHARM_VM_OPTIONS 环境变量指定的位置。如果指定的文件存在，它将覆盖所有其他 JVM 选项文件。
如果当前的 PyCharm 实例由 Toolbox 应用管理，请打开 Toolbox 应用，在相关 IDE 实例旁点击，然后选择设置。在配置下，找到 Java 虚拟机选项，并点击编辑。
如果您运行的是独立的 PyCharm 实例，请检查配置目录。
如果在上述位置都未定义 JVM 选项文件，PyCharm 将使用默认 JVM 选项文件。请勿修改该文件。仅将其用于查看 PyCharm 使用的默认选项。

常用选项

在大多数情况下，JVM 选项的默认值应该是最佳的。以下是最常修改的选项：

-Xmx

限制 JVM 在运行 PyCharm 时可分配的最大堆大小。默认值取决于平台。如果您遇到速度变慢的问题，您可以增大此值。例如，要将该值设置为 2048 兆字节，请将此选项更改为 -Xmx2048m。

有关详细信息，请参阅增大 IDE 的堆内存。

-Xms

指定 JVM 为运行 PyCharm 分配的初始堆大小。默认值取决于平台。通常设置为最大允许内存的一半左右（请参见 -Xmx ），例如 -Xms1024m。

-XX:NewRatio

指定堆中新生代与老年代大小的比率。在大多数情况下，建议将该比率设置在 2 到 4 之间。这样将把新生代的大小分别设为老年代的 1/2 到 1/4，当您经常只处理一个项目且每次只打开少量文件时，这样的设置较为合适。但是，如果您经常打开新文件并在多个项目之间切换，则可能需要增大新生代。在这种情况下，请尝试设置 -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 支持的建议下更改这些属性。

最后修改日期： 2025年 12月 2日