PyCharm 2025.3 Help

平台属性参考'

idea.properties 文件可以同时包含特定于 IntelliJ 平台的设置以及其他相关属性。 要配置平台属性,请在 帮助 菜单中,点击 编辑自定义属性

您可以将宏与任何属性名称配合使用以插入其值,例如,使用 ${user.home} 指定相对于用户主目录的路径。

属性

默认值

说明

idea.chooser.lookup.for.project.dirs

true

定义 PyCharm 是否应在目录内查找有效项目,以使用相应图标标记此类目录。 如果禁用此属性,则不会在用户主目录之外执行此类查找。

idea.cycle.buffer.size

1024

设置控制台循环缓冲区的最大大小(以千字节( KB )为单位)。 如果控制台输出大小超过此值,将删除最早的行。 要禁用循环缓冲区,请设置 idea.cycle.buffer.size=disabled

idea.dynamic.classpath

false

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

idea.max.content.load.filesize

20000

设置 PyCharm 能打开并处理的文件的最大大小(以千字节( KB )为单位)。

idea.max.intellisense.filesize

2500

设置 PyCharm 提供代码辅助的文件的最大大小(以千字节( KB )为单位)。 对大型文件提供代码辅助可能会降低编辑器性能并增加内存占用。

idea.max.vcs.loaded.size.kb

20480

设置 PyCharm 在 比较更改 时为显示过往文件内容而加载的最大大小(以千字节( KB )为单位)。

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 提供代码辅助的最大文件大小(千字节( KB ))。 如果启用了代码辅助,文件越大,编辑器的运行越慢,整体系统内存占用越高。 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 内运行进程时使用特殊的启动器。 使用启动器可启用 "软退出" 和 "线程转储" 功能。

idea.no.launcher=false

类路径

为避免类路径过长。

idea.dynamic.classpath=false

ProcessCanceledException

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

除非在调试 IDE 本身,否则请勿取消注释。 否则将出现显著的变慢和卡死。

idea.ProcessCanceledException=disabled

弹出窗口权重

idea.popup.weight 属性有两个可选值:"heavy" 和 "medium"。 如果您的 WM 配置为 "焦点随鼠标并自动提升窗口",则必须将此属性设置为 "medium"。 这可避免在某些配置中出现弹出菜单问题。

idea.popup.weight=heavy

系统抗锯齿

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

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

重绘

禁用此属性可能会导致闪烁等视觉问题,并在某些显示适配器上无法重绘。

sun.java2d.noddraw=true

编辑器性能

在 Windows 下移除此属性可能会导致编辑器性能下降。

sun.java2d.d3d=false

滚动缓慢

针对 JDK 6 中滚动缓慢的解决方法。

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 兼容模式。

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

jmx.serial.form=1.0

致命错误通知

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

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