Pycharm
 
2023.3
快捷方式：Windows
获取 PyCharm
  1. 配置 PyCharm
  2. 高级配置

高级配置

最后修改时间：2023 年 11 月 20 日

除了 IDE 设置中可用的标准选项之外，PyCharm 还允许您执行底层平台和 Java 运行时的低级配置。

警告

如果您不确定自己在做什么，这可能会导致意外问题并导致您的 PyCharm 安装无法运行。请联系JetBrains 支持，获取有关选项和值的说明，这些选项和值可能会帮助您解决您尝试解决的任何问题。

JVM 选项

PyCharm 在 Java 虚拟机 (JVM) 上运行，该虚拟机具有各种控制其性能的选项。用于运行 PyCharm 的默认选项在 IDE 安装目录中指定：

<IDE_HOME> \bin \pycharm64.exe.vmoptions

警告

不要更改默认文件中的 JVM 选项，因为它会在 PyCharm 更新时被替换。此外，对于 macOS，编辑此文件会违反应用程序签名。

配置 JVM 选项

执行以下操作之一，在配置目录中使用 JVM 选项创建默认文件的副本，该副本将覆盖原始文件：

  • 转到帮助| 编辑自定义虚拟机选项。

  • 如果您没有打开任何项目，请在欢迎屏幕上单击配置，然后单击编辑自定义 VM 选项。

  • 如果无法启动 PyCharm，请手动将带有 JVM 选项的默认文件复制到 PyCharm配置目录。

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

笔记

如果您使用 Toolbox 应用程序，它会管理安装和配置目录，并允许您为每个 IDE 实例配置 JVM 选项。打开 Toolbox 应用程序，单击螺母图标相关 IDE 实例旁边的 ，然后选择“设置”。

找到 JVM 选项文件

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

  1. 由环境变量指定的位置PYCHARM_VM_OPTIONS。如果指定的文件存在，它将覆盖所有其他 JVM 选项文件。

  2. 如果 Toolbox 应用程序管理您当前的 PyCharm 实例，请打开 Toolbox 应用程序，单击螺母图标相关 IDE 实例旁边的 ，然后选择Settings。在“配置”下，找到“Java 虚拟机”选项并单击“编辑”。

  3. 如果您正在运行独立的 PyCharm 实例，请检查配置目录。

  4. 如果前面的位置没有定义 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，这将使年轻代与老一代一样大，从而允许对象在年轻代中保留更长时间。

有关可用 JVM 选项的更多信息，请参阅java命令参考。

平台属性

PyCharm 使您能够自定义各种特定于平台的属性，例如用户安装的插件的路径和支持的最大文件大小。用于运行 PyCharm 的默认属性在 IDE 安装目录中指定：

<IDE_HOME> \bin \idea.properties

警告

不要更改默认文件中的平台属性，因为它会在 PyCharm 更新时被替换。此外，对于 macOS，编辑此文件会违反应用程序签名。

配置平台属性：

执行以下操作之一在配置目录中创建一个空的idea.properties文件，该文件将覆盖原始文件中的值：

  • 转到帮助| 编辑自定义属性。

  • 如果您没有打开任何项目，请在“欢迎”屏幕上单击“配置” ，然后选择“编辑自定义属性”。

  • 如果无法启动PyCharm，请在PyCharm配置目录中手动创建一个空的idea.properties文件。

如果您没有 PyCharm 配置目录的写入权限，则可以添加环境变量来指定idea.propertiesPYCHARM_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。

PyCharm 提供了许多其他属性来定义与环境（窗口管理器、启动器、文件系统等）的交互。它们中的大多数行为就像隐藏设置（从某种意义上说，它们没有明显暴露），在某些情况下您可能需要启用或禁用它们。仅当JetBrains 支持人员建议时才更改这些属性。