Unity3D

Unity3D：Console窗口

ygtu

Apr 23, 2023 • 8 min read

在线工具推荐：3D数字孪生场景编辑器 - GLTF/GLB材质纹理编辑器 - 3D模型在线转换 - Three.js AI自动纹理开发包 - YOLO 虚幻合成数据生成器 - 三维模型预览图生成器

Console 窗口

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

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

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

控制台窗口界面

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

A. 控制台工具栏具有用于控制如何显示邮件以及用于搜索和筛选邮件的选项。

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

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

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

Console 工具栏选项

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

选项：		功能：
清楚		删除从代码生成的任何消息，但保留编译器错误。打开带有清除选项的下拉菜单。
	播放时清除	每当进入播放模式时就会自动清空控制台。
	构建时清除	在构建项目时清空控制台。
	重新编译时清除	在重新编译项目时清除控制台。
崩溃		仅显示重复出现的错误消息的第一个实例。这对于运行时错误（如空引用）非常有用，这些错误有时会在每次帧更新时生成。
错误暂停		每当从脚本调用 `Debug.LogError` 时暂停播放。使用此选项可在执行中的特定点冻结播放并检查场景。从脚本调用 `Debug.Log` 时，此选项不会暂停播放。
[附加到玩家]		打开一个下拉菜单，其中包含用于连接到远程设备上运行的开发版本以及在控制台中显示其 Player 日志的选项。此选项标有目标开发版本（即“控制台”窗口中显示的日志的内部版本）的名称。如果控制台未连接到远程生成，则会将其标记为编辑器，以显示控制台窗口中显示的日志来自本地 Unity 编辑器。
	玩家日志记录	如果控制台连接到远程开发版本，则会为该版本启用播放器日志记录。禁用此选项将挂起日志记录，但控制台仍与目标版本保持连接。禁用此选项还会隐藏此下拉菜单中的其余选项。选择“玩家日志记录”下方列出的任何内部版本，以在控制台窗口中显示其日志。
	编辑器	如果控制台连接到远程开发版本，请选择此选项以显示来自本地 Unity Player 的日志，而不是来自远程构建的日志。
	`<Enter IP>`	打开“输入播放器 IP”对话框，您可以在其中指定远程设备上开发版本的 IP 地址。若要连接到生成，请在对话框中选择“连接”，然后将其添加到下拉菜单底部的开发生成列表中。
	[开发版本]	列出可用的开发版本。这包括自动检测的版本，以及使用“输入 IP”选项添加的版本。

搜索和筛选控制台输出

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

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

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

搜索会查找您在搜索栏中键入的任何内容的完全匹配项。您不能同时搜索两个不同的字词，也不能使用常见的搜索引擎运算符。

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

按钮	功能
消息切换	显示控制台中的消息数。单击以显示或隐藏消息。
警告开关	显示控制台中的警告数。单击以显示或隐藏警告。
错误开关	显示控制台中的错误数。单击以显示或隐藏错误。