PyCharm 2025.2 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

定义是否应将长 classpath 写入文件并从中读取,而不是通过命令行传递。 默认情况下,此功能是禁用的,如果命令超过 shell 允许的字符限制,则会失败。

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 配置文件夹路径

如果您想自定义 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

控制台循环缓冲区

此选项控制控制台循环缓冲区:保持控制台输出大小不超过指定的缓冲区大小(千字节)。 较旧的行将被删除。 要禁用循环缓冲区,请设置 idea.cycle.buffer.size=disabled

idea.cycle.buffer.size=1024

启动器

配置是否在 IDE 中运行进程时使用特殊启动器。 使用启动器可启用“软退出”和“线程转储”功能。

idea.no.launcher=false

类路径

避免过长的 classpath

idea.dynamic.classpath=false

ProcessCanceledException

取消注释此属性以防止 IDE 在检测到用户活动时抛出 ProcessCanceledException。 此选项仅对插件开发人员有用,用于调试在后台错误分析线程中执行的与 PSI 相关的活动。

除非您正在调试 IDE 本身,否则不要取消注释此选项。 否则会发生显著的性能下降和卡顿。

idea.ProcessCanceledException=disabled

弹出窗口权重

idea.popup.weight 属性有两个可能的值:“heavy”和“medium”。 如果您的窗口管理器配置为“焦点跟随鼠标并自动提升”,则必须将此属性设置为“medium”。 它可以防止某些配置中的弹出菜单问题。

idea.popup.weight=heavy

系统抗锯齿

使用系统中的默认抗锯齿,即覆盖“设置|编辑器|外观|使用抗锯齿字体”选项的值。 例如,在使用 Windows 远程桌面连接时可能有用。

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 会复制库 jar 文件以防止其被锁定。 如果不希望复制,请指定“true”。

idea.jars.nocopy=false

以调试模式启动 JVM

用于以调试模式启动 JVM 的 VM 选项值。 某些 JRE 以不同的方式定义它(在 Oracle VM 中为 -XXdebug)。

idea.xdebug.key=-Xdebug

切换到 JMX 1.0 兼容模式。

取消注释此选项以便在使用 J2SDK 1.5+ 运行 PyCharm 时与运行 1.4 的应用服务器(如 WebLogic)一起工作。

jmx.serial.form=1.0

致命错误通知

如果您希望即时收到有关 IDE 或已安装插件发生的致命错误的视觉通知,请更改为“enabled”。

idea.fatal.error.notification=disabled
最后修改日期: 2025年 9月 26日