输出面板

本页面为自动翻译,可能包含错误。如果发现问题,请通过“编辑此页面”链接帮助修正。

Studio 会捕获所有 std.log 消息——来自引擎、编辑器,以及(在 Play mode 中)您自己的脚本——并将其收录到输出面板中,以与终端打印相同的方式着色并加上时间戳。

它在哪里

输出面板是一个普通的可停靠面板,默认与资源放在一起形成标签页。可以像其他任何面板一样拖动它、将它与其他内容放在一起形成标签页,或使其浮动;通过视图 ▸ 显示输出切换它。

从您自己的代码中记录日志

有关如何从脚本记录日志,请参阅组件:日志记录。简而言之:使用普通的 std.log(可选地使用 std.log.scoped(.my_script) 来设置您自己的类别)——它会在 Play mode 中显示在这里,也会显示在已构建游戏的控制台中。

过滤

  • 级别图标(bug / info / warning / error)用于切换每种严重程度——显示时会高亮。
  • 类别下拉菜单将列表缩小到一个作用域(您自己脚本的,或引擎子系统的)——"All" 显示全部。
  • 搜索框匹配消息文本(不区分大小写)。
  • "..." ▸ Show system messages(默认关闭)会显示 SDL/dvui 自身的内部信息,归入单一的 Studio 类别——默认关闭,以便让您自己和您游戏的消息处于优先位置。

所有这些过滤器可以组合使用,也同样适用于复制

折叠重复消息

  • 连续的相同消息始终会折叠为一行,带有 ×N 徽章,无论下面的开关如何设置。
  • Collapse(工具栏开关)会进一步将可见历史记录中任何位置的所有匹配消息合并为一行,并附带一个滚动总计——类似于 Unity 的 "Collapse" 按钮,适用于同一警告在整个会话中时断时续出现的情况。

打开源代码位置

当消息包含可识别的 文件:行号 引用时,会内联显示。双击该行可在您配置的编辑器中打开它——设置 $VISUAL$EDITOR(识别 codecode-insiderssublzedvim/nvim);否则会回退到您操作系统对该文件的默认处理程序(不跳转到具体行)。

堆栈跟踪

捕获了堆栈跟踪的错误条目会显示一个 ▸/▾ 箭头——点击它即可符号化并显示跟踪信息(延迟执行,仅在展开时进行,因为符号化有实际开销)。没有跟踪信息的条目(大多数非错误消息)不显示任何箭头。

自动滚动、清除、复制

  • 自动滚动(默认开启)会将视图固定在最新消息上,类似控制台的行为;取消勾选可在不与新输出争抢的情况下回读历史记录。
  • Clear 清空日志。
  • Copy 将当前可见的所有条目(遵循您的过滤器和 Collapse 设置)复制到剪贴板,按从旧到新的顺序——便于粘贴到错误报告或 AI 助手中。

← 所有文档 编辑此页面