简介
控制台（Console）显示错误、警告和编辑器生成的其他消息。这些错误和警告可帮助您查找项目中的问题，例如脚本编译错误。它们还会提醒您编辑器自动执行的操作，例如替换丢失的源文件，防止项目中其他地方出现问题。
为了帮助您调试项目，请使用 API 中的 Debug 类将消息打印到控制台窗口中。
【SandMod_Basics_Console001.png】
编辑器默认布局下， 控制台（Console）停放在 SandMod 编辑器窗口正下方或 项目窗口（Project）同一个选卡页内。点击查看大图。
显示控制台
在 SandMod 编辑器的默认布局下，所有子编辑器都会有 控制台（Console），如果没有显示或窗口消失，您可以在 菜单栏（Menu）中点选 窗口（Window） > 视图（Panel） > 控制台（Console） 进行显示。
【SandMod_Basics_Project002.png】
控制台构成
控制台（Console）分为以下功能控件构成：
【SandMod_Basics_Project003.png】
- 工具栏（Toolbar），控制台工具栏具有用于控制如何显示消息以及用于搜索和过滤消息的选项。
- 日志内容列表（Console list），控制台以列表形式显示每条记录消息的条目。选择一条消息条目后可在 日志完整内容（Console Detail Area）板块中查看其完整文本内容。
- 日志完整内容（Console Detail Area），日志完整内容板块显示所选日志的全文。
工具栏
控制台（Console）工具栏包括以下按钮：
【SandMod_Basics_Project004.png】
| 序号 | 名称 | 描述 |
|---|---|---|
| 1 | 清除（Clear） | 点击此按钮，将删除从代码中生成的任何消息，清空控制台中除编译器错误外的所有输出内容。 【SandMod_Basics_Project005.gif】 |
| 2 | 折叠（Collapse） | 当此选项被点击至高亮时，若有多条重复出现的消息条目，仅在 日志内容列表 显示第一条，并在消息条目的右方显示该条目重复的次数。 【SandMod_Basics_Project006.png】 有时一些错误消息或信息在每帧更新时生成，此功能能更方便查看和定位错误原因。 |
| 3 | 错误暂停（Error Pause） | 当此选项被点击至高亮时，每当 Debug.Error 在脚本中被调用或者脚本、逻辑发生错误时游戏项目都会暂停播放，控制台停止更新。 此功能可以用于在执行特定逻辑时暂停播放并检查。当脚本调用 Debug.Log 或者 Debug.Warning 时，此选项启用也不会暂停播放。 |
| 4 | 搜索栏（Search） | 通过搜索词筛选具体的消息条目。具体操作方法可参阅 搜索和过滤输出 小节。 |
| 5 | 日志类型（Console Type） | 统计 日志内容列表（Console list）中该类型的所有消息条目数。单击可显示或隐藏 日志内容列表 中该类型的所有消息条目。具体操作方法可参阅 搜索和过滤输出 小节。 |
消息条目
消息条目就是在 日志内容列表（Console list） 中每条记录消息的条目。
【SandMod_Basics_Project007.png】
每条消息条目包含以下内容：
【SandMod_Basics_Project008.png】
| 序号 | 名称 | 描述 |
|---|---|---|
| 1 | 消息条目类型 | 以图标的形式显示该信息条目属于什么类型，具体类型可参阅 控制台消息条目类型 小节。 |
| 2 | 输出时间 | 通过本地时间（时：分：秒）的方式描述该信息条目的具体输出时间。 |
| 3 | 消息内容 | 显示消息内容，可以是字符串或者数字。 |
| 4 | 消息条目数量 | 当 控制台（Console）工具栏中 折叠（Collapse）选项被点击至高亮时才会显示，展示了该条目重复的次数。 |
控制台消息条目类型
消息条目分为以下几种类型：
| 名称 | 图标 | 描述 |
|---|---|---|
| 信息（Log） | 【SandMod_Basics_Project009.png】 | 通常用来显示正在进行的操作。脚本中用 Debug 类下的 Debug.Log 输出此类型消息。 |
| 警告（Warning） | 【SandMod_Basics_Project010.png】 | 用于提示您最好进行处理的异常情况，但不处理也不会影响运行。脚本中用 Debug 类下的 Debug.Warning 输出此类型消息。 |
| 错误（Error） | 【SandMod_Basics_Project011.png】 | 表示出现了严重错误，必须解决才能进行下一步操作或者让游戏项目正常运行。脚本中用 Debug 类下的 Debug.Error 输出此类型消息。 |
搜索和过滤输出
一般情况下，游戏项目会有大量的消息输出，您可以通过搜索或按照消息条目的类型对消息条目进行过滤，找到您要找的消息条目。
搜索过滤
您可以从搜索栏中搜索控制台消息中的特定关键字。当您键入搜索词时，控制台会过滤消息条目以仅显示包含匹配文本的消息条目。您也可以搜索控制台记录消息的时间。
| -------------- 如在搜索栏搜索 XX 时 XX 分 XX 秒输出的所有消息条目。 【SandMod_Basics_Project012.png】 -------------- |
搜索过程会查找与您在搜索栏中输入完全匹配的内容。您不能同时搜索两个不同的搜索词，也不能使用常见的搜索引擎运算符。
按消息条目类型过滤
在控制台工具栏的日志类型选项中有三个子选项，每个子选项对应一个控制台消息条目类型。具体类型介绍可参阅 控制台消息条目类型 小节。
【SandMod_Basics_Project013.png】
每个子选项右侧的数字显示控制台中的对应类型的消息条目数。
【SandMod_Basics_Project014.png】
各个类型的子选项被点击至高亮时，可显示 日志内容列表（Console list）中该类型的所有消息条目。
| -------------- 例如，您只想在 日志内容列表 中显示所有类型的消息条目，则需要设置所有类型子选项都处于高亮状态。 【SandMod_Basics_Project015.png】 -------------- |
若某个类型的子选项被点击至非高亮时，日志内容列表（Console list）中该类型的所有消息条目将被隐藏。
| -------------- 如果您只想在 日志内容列表 中显示 错误（Error）类型的消息条目，则需要设置 信息（Log）和 警告（Warning）类型子选项都处于非高亮状态。 【SandMod_Basics_Project016.png】 -------------- |