Version: 6000.3
语言: 中文
“后台任务”窗口
其他窗口

控制台窗口

控制台窗口显示编辑器生成的错误、警告和其他消息。这些错误和警告可帮助您查找项目中的问题,例如脚本编译错误。它们还会提醒你编辑器自动执行的作,例如替换丢失的元文件,这可能会导致项目中其他位置出现问题。

为了帮助你调试项目,请使用 Debug 类将你自己的消息打印到控制台。例如,您可以在脚本中的特定点打印变量的值,以查看它们如何变化。

本页介绍了在使用“控制台”窗口时可以使用的选项,以及如何通过搜索特定关键字来筛选邮件。

控制台窗口界面

要打开控制台,请从 Unity 的主菜单转到窗口>常规>控制台

“控制台”窗口显示一系列错误消息和警告。
“控制台”窗口显示一系列错误消息和警告。

A. 控制台工具栏Unity 编辑器顶部的一排按钮和基本控件,允许您以各种方式(例如缩放、翻译)与编辑器交互。更多信息
请参阅术语表
具有用于控制如何显示消息以及搜索和筛选消息的选项。

B. 控制台窗口菜单包含用于打开日志文件、控制列表中每条消息的可见量以及设置堆栈跟踪选项的选项。

C. 控制台列表显示每个记录消息的条目。选择一条消息以在详细信息区域中显示其整个文本。您可以在此处选择要显示的每条消息的行数。请参阅下面的调整行数

D. 详细信息区域显示选定消息的全文。如果启用堆栈跟踪,则详细信息区域将代码文件中特定行的引用显示为可单击的链接。

控制台工具栏选项

“控制台”窗口的工具栏具有用于控制如何显示消息以及搜索和筛选消息的选项。

选项 功能
清楚 删除从代码生成的任何消息,但保留编译器错误。

打开一个包含清除选项的下拉菜单。
播放时清除 每当您进入游戏模式时,都会自动清除控制台。
生成时清除 在构建项目时清除控制台。
重新编译时清除 重新编译项目时清除控制台。
崩溃 仅显示重复出现的错误消息的第一个实例。

这对于有时在每次帧更新时生成的运行时错误(例如空引用)非常有用。
错误暂停 每当您调用时暂停播放Debug.LogError从脚本中。

使用此选项可以在执行中的特定点冻结播放并检查场景。当您调用时,此选项不会暂停播放
Debug.Log从脚本中。
[附加到玩家] 打开一个下拉菜单,其中包含用于连接到在远程设备上运行的开发版本的选项,并在控制台中显示其玩家日志。

此选项标有目标开发内部版本的名称(即“控制台”窗口中显示的日志的内部版本)。如果控制台未连接到远程构建,则将其标记为 Editor,以显示控制台窗口中显示的日志来自本地 Unity 编辑器。
玩家日志记录 如果控制台连接到远程开发版本,则会启用该版本的玩家日志记录。

禁用此选项会暂停日志记录,但控制台仍会连接到目标构建。

禁用此选项还会隐藏此下拉菜单中的其余选项。

选择 玩家日志记录(Player Logging) 下方列出的任何版本,以在 控制台(Console) 窗口中显示其日志。
编辑 器 如果控制台连接到远程开发版本开发版本包括调试符号并启用分析器。更多信息
请参阅术语表
,选择此选项以显示来自本地 Unity Player 的日志,而不是来自远程生成的日志。
<Enter IP> 打开 输入播放器IP 对话框,您可以在其中指定远程设备上开发版本的 IP 地址。

若要连接到生成,请在对话框中选择“连接”,并将其添加到下拉菜单底部的开发生成列表中。
[开发版本] 列出可用的开发版本。这包括自动检测的内部版本,以及使用“输入 IP”选项添加的内部版本。

搜索和过滤控制台输出

您可以从控制台搜索栏中搜索控制台消息中的特定关键字。键入搜索词时,控制台会过滤邮件以仅显示包含匹配文本的邮件。控制台仅突出显示消息文本中的第一个匹配项,并且仅当它位于消息的可见部分时(请参阅下面的调整行数)。

搜索术语“名称”会突出显示每封邮件中的第一个匹配项
搜索术语“名称”会突出显示每封邮件中的第一个匹配项

您可以搜索任何控制台消息中出现的任何内容,包括数字和特殊字符。例如,您可以搜索控制台记录消息的时间。

搜索会查找与您在搜索栏中输入的任何内容完全匹配的内容。您不能同时搜索两个不同的术语,也不能使用常见的搜索引擎运算符。

您还可以按类型筛选控制台消息。单击搜索栏旁边的按钮进行切换:

按钮 功能
消息开关

消息开关
显示控制台中的消息数。单击以显示或隐藏消息。
警告开关

警告开关
显示控制台中的警告数。单击以显示或隐藏警告。
错误开关

错误开关
显示控制台中的错误数。单击以显示或隐藏错误。

调整行数

每个控制台条目最多可以有 10 行长。

要控制列表中每个条目的可见行数,请单击 控制台(Console) 菜单按钮,然后从菜单中选择 日志条目(Log Entry > [X] 行),其中 [X] 是每个条目要显示的行数。

日志条目行数
日志条目行数

行数越大,每个条目的文本越多,但在任何给定时间可见的条目数会减少。行数不会影响控制台搜索功能,该功能始终搜索完整的消息文本。如果匹配的文本位于隐藏行上,则搜索会在结果中返回消息,但不会展开消息以显示或突出显示匹配的文本。您可以在详细信息区域中看到完整的消息文本,但匹配的文本不会在那里突出显示。

堆栈跟踪日志记录

Unity 控制台消息和日志文件可以包含详细的堆栈跟踪信息。您可以使用堆栈跟踪日志记录设置来控制堆栈跟踪信息量。

从控制台打开日志文件

Unity 或您的代码写入控制台窗口的所有内容也会写入日志文件。您可以从控制台窗口菜单打开日志文件。选择打开玩家日志(Player Log)由独立播放器创建的.log文件,其中包含事件记录,例如脚本执行时间、编译器版本和 AssetImport 时间。日志文件可以帮助诊断问题。更多信息
请参阅术语表
打开编辑器日志

“后台任务”窗口
其他窗口