翻译Unity中文版的初衷是因为官方提供的中文版存在缺陷,而且翻译的不全。现在基于Unity2023.2版本对官方文档进行翻译。
控制台窗口 🔗
控制台窗口显示编辑器生成的错误、警告和其他消息。这些错误和警告可以帮助您找到项目中的问题,例如脚本编译错误。它们还可以提醒您编辑器自动执行的操作,例如替换丢失的元文件,这可能会在项目的其他地方引发问题。
为了帮助您调试项目,可以使用调试类将自己的消息打印到控制台。例如,您可以打印脚本中某些位置的变量值,以查看它们的变化情况。
本页面介绍了在使用控制台窗口时可用的选项,以及如何通过搜索特定关键字来过滤消息。
控制台窗口界面 🔗
要打开控制台,请从 Unity 的主菜单中选择 Window > General > Console。
A. 控制台的 工具栏 提供了控制消息显示方式、搜索和筛选消息的选项。
B. 控制台窗口菜单提供了打开日志文件、控制列表中每个消息的可见行数以及设置堆栈跟踪选项的选项。
C. 控制台列表显示了每条记录的消息。选择一条消息可以在详细区域显示其完整文本。在这里,您可以选择每条消息显示多少行。请参阅下面的调整行数。
D. 详细区域显示了所选消息的完整文本。如果启用了堆栈跟踪,详细区域将显示代码文件中特定行的引用作为可点击的链接。
控制台工具栏选项 🔗
控制台窗口的工具栏提供了控制消息显示方式、搜索和筛选消息的选项。
选项: | 功能: | |
---|---|---|
清除 | 移除由您的代码生成的任何消息,但保留编译器错误。打开下拉菜单以选择清除选项。 | |
游戏播放时清除 | 在进入游戏模式时自动清除控制台中的消息。 | |
构建时清除 | 在构建项目时清除控制台中的消息。 | |
重新编译时清除 | 在重新编译项目时清除控制台中的消息。 | |
折叠 | 仅显示重复的错误消息的第一个实例。这在运行时错误中非常有用,例如每帧更新时都会发生的空引用错误。 | |
出错暂停 | 每当您从脚本中调用 Debug.LogError 时,播放暂停。使用此选项可以在执行的特定位置冻结播放并检查场景。调用 Debug.Log 时不会暂停播放。 |
|
[连接到播放器] | 打开下拉菜单,以连接到运行在远程设备上的开发构建,并在控制台中显示它们的播放器日志。此选项的标签是目标开发构建的名称(即在控制台窗口中显示的日志的构建)。如果控制台未连接到远程构建,则标签为Editor,表示在控制台窗口中显示的日志来自本地Unity编辑器。 | |
播放器日志 | 如果控制台已连接到远程开发构建,则为该构建启用播放器日志记录。禁用此选项会暂停日志记录,但控制台仍会连接到目标构建。禁用此选项还会隐藏此下拉菜单中的其余选项。选择下面 播放器日志 下列出的任何构建,可以在控制台窗口中显示其日志。 | |
编辑器 | 如果控制台已连接到一个远程开发构建,选择此选项可显示本地Unity播放器的日志,而不是远程构建的日志。 | |
<输入IP地址> | 打开输入播放器IP地址对话框,您可以在其中指定远程设备上开发构建的IP地址。要连接到该构建,请在对话框中选择连接,并将其添加到下拉菜单底部的开发构建列表中。 | |
[开发构建列表] | 列出可用的开发构建。包括自动检测到的构建以及使用输入IP地址选项添加的构建。 |
搜索和过滤控制台输出 🔗
您可以从控制台搜索栏中搜索特定关键字的控制台消息。当您输入搜索术语时,控制台会过滤显示只包含匹配文本的消息。控制台只在消息文本中的可见部分中突出显示第一个匹配项(参见下面的调整行数)。
您可以搜索任何出现在控制台消息中的内容,包括数字和特殊字符。例如,您可以搜索控制台记录消息的时间。
搜索栏中的搜索将查找与您键入的内容完全匹配的结果。您不能同时搜索两个不同的术语,也不能使用常见的搜索引擎运算符。
您还可以按类型筛选控制台消息。单击搜索栏旁边的按钮可以切换:
Button | Function |
---|---|
![]() |
显示控制台中的消息数量。单击以显示或隐藏消息。 |
![]() |
显示控制台中的警告数量。单击以显示或隐藏警告。 |
![]() |
显示控制台中的错误数量。单击以显示或隐藏错误。 |
调整行数 🔗
每个控制台条目最多可以有10行。
要控制在列表中可见的每个条目的行数,请单击控制台菜单按钮,然后从菜单中选择Log Entry > [X] Lines,其中**[X]**是每个条目要显示的行数。
更大的行数可显示每个条目的更多文本内容,但会减少在任意给定时间内可见的条目数量。行数不影响控制台的搜索功能,搜索始终搜索完整的消息文本。如果匹配的文本位于隐藏的行上,搜索结果中会返回该消息,但不会展开或突出显示匹配的文本。您可以在详细区域中查看完整的消息文本,但其中的匹配文本不会突出显示。
堆栈跟踪记录 🔗
Unity控制台消息和日志文件可以包含详细的堆栈跟踪信息。您可以使用堆栈跟踪记录设置来控制堆栈跟踪信息的数量。
从控制台打开日志文件 🔗
Unity或您的代码写入控制台窗口的所有内容也会写入日志文件中。您可以从控制台窗口菜单中打开日志文件。选择Open Player Log或Open Editor Log。
结论 🔗
搬砖愉快!