PhpStorm 2025.2 Help

日志高亮

为了更好的可读性和导航,PhpStorm 会高亮显示在 IDE 编辑器或终端中打开的 .log 文件中的不同元素。

日志文件高亮

日志高亮基于可配置的日志格式和配色模式。 Laravel、Symfony 和 WordPress 日志文件的高亮是预配置并默认在 PhpStorm 中支持的。 您可以自定义预配置的日志格式和高亮模式,或者在 设置 Ctrl+Alt+S | 编辑器 | 日志高亮 中添加新的。

日志高亮设置

项目

描述

在滚动条上显示热图

取消选中该复选框以禁用滚动条上的日志高亮热图。

在日志中高亮显示链接和代码引用

取消选中该复选框以禁用日志文件中的链接和代码引用的高亮显示。

允许编辑小于以下大小的日志文件(KB)

指定可编辑日志文件的最小大小(KB)。

导入

点击该按钮以导入带有日志格式设置的现有 .xml 文件。

导出

该按钮仅在您从下面的 日志格式消息模式筛选器 表中选择了至少一项后显示。

点击导出选中的日志高亮设置为 .xml 格式。

重置选区

该按钮仅在您从下面的 日志格式消息模式筛选器 表中选择了至少一项后显示。

点击以重置选择。

日志格式

在此部分中,您可以添加自定义日志格式或编辑/删除预配置的格式。

要添加一个新的日志格式,请点击 创建模板按钮 ,输入新日志格式的名称并指定:

  • 消息模式: 一个正则表达式,用于定义如何解析日志文件中的日志消息。 它应包含用于时间、严重性、类别和消息的捕获组。 如果日志格式中没有这些项,可以安全地省略它们。

  • 消息开始模式: 一个正则表达式,用于定义日志文件中日志消息开始的行。

    确保以 ^ 开始您的模式,以确保正确匹配多行消息。

  • 时间格式: 当前日志格式使用的日期和时间格式。

  • 时间捕获组、严重性捕获组、类别捕获组 :时间、严重性和类别的捕获组索引。 捕获组从 1 开始编号。 如果您没有某一项的捕获组,请指定 0

  • 将消息模式应用于所有消息行 :选中复选框以将消息模式应用到多行消息的每一行。 当未选中复选框时,该模式仅应用于消息的第一行,其余所有行均视为该消息的一部分。

    对于有许多多行消息的日志,将此复选框留空有助于显著提高性能。

模式

在此部分中,您可以添加自定义高亮模式或编辑/删除预配置的模式。 高亮模式应用于 日志格式 部分中指定的捕获组。 每个高亮模式由一个正则表达式模式和一个着色操作组成,如果文本匹配该模式,则应用此操作。

要编辑现有模式,请在表中选择相应的行,然后点击部分工具栏上的 。 在打开的对话框中,指定:

  • 操作: 从下拉列表中选择一个可用的高亮操作:

    • 高亮行 — 使用配置的样式高亮整个消息。

    • 高亮字段 — 高亮匹配出现的字段(捕获组)。

    • 高亮匹配项 — 仅高亮匹配的文本。

  • 日志格式: 从下拉列表中选择一个特定的日志格式,或 任意 以将模式应用到所有创建的日志格式。

  • 捕获组: 捕获组索引,用于正则表达式中 Pattern 字段定义。

  • 粗体: 选中复选框以加粗高亮定义的日志范围。

  • 斜体: 选中复选框以斜体高亮定义的日志范围。

  • 前景: 选中复选框并点击右侧的值字段以打开 选择颜色 对话框并指定前景色。

  • 背景: 选中复选框并点击右侧的值字段以打开 选择颜色 对话框并指定背景色。

  • 在条纹上显示: 选中复选框以在滚动条上显示检测到的模式出现的标记。

最后修改日期: 2025年 9月 26日