---
title: 控制台窗口引用
product: Unity Editor
version: '6000.0'
latest_version: '7000.0'
status: This page documents version 6000.0. The latest version is 7000.0.
canonical: https://docs.unity.com/zh-cn/engine/6000.0/manual/unity-editor/editor-windows-views-reference/console
latest_url: https://docs.unity.com/zh-cn/engine/7000.0/manual/unity-editor/editor-windows-views-reference/console.md
generated_at: 2026-11-18T10:57:27.630Z
locale: zh-cn
---

# 控制台窗口引用

> 脚本ity Editor 中的报错消息、警告和调试日志。

**控制台**窗口显示 Editor 生成的错误、警告和其他消息。这些错误和警告有助于在Project中查找问题，例如脚本编译错误。它们还会提醒您 Editor 已自动执行的操作，例如替换缺失的元文件，这些操作可能会导致Project其他地方出现问题。

为了帮助调试项目，请使用[调试](/engine/6000.0/manual/scripting/debugging-and-diagnostics/class-debug.md)类将您自己的消息打印到控制台。例如，可以在脚本中的某些点打印变量的值，以查看它们的Change。

Page面介绍使用 控制台窗口When可以使用的选项，以及如何通过searching指定的关键字过滤器消息。

## 控制台窗口界面##console-window-interface

要打开控制台，请从 Unity 的主菜单转到 **Window** > **General** > **控制台**。


**The Console window displays a series of error messages and a warning.:**
![](/api/media?file=/engine/6000.0/media/images/Console.png)

A控制台Editor具有用于控制如何显示消息以及用于[search和过滤](#search)消息的选项。

B.Console 窗口菜单包含用于[打开日志文件](#log-file)、控制列表中可见[每条 message](#line-count) 的选项以及设置 stack trace 选项。

C++控制台列表显示每条记录 message 的条目。选择一条message可在细节信息区域显示其整个文本。您可以选择在此处显示每条 message 的行数。请参阅下面[的调整线数量](#line-count)。

**-D**细节区域显示选定 message 的全文。如果Enablestack trace，细节信息区域会将代码文件中对指定的行的引用显示为可单击的链接。

## 控制台 工具栏选项项##console-toolbar-options

控制台窗口工具栏栏具有用于控制如何显示消息以及searching和过滤消息的选项。

| **选项**               |              | **函数**                                                                                                                                                                                                             |
| -------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **清除**               |              | 删除从代码生成的Any消息，但保留编译编译器错误。打开包含清除选项的下拉菜单。                                                                                                                                                                            |
|                      | 清除 ON 播放     | 每当进入播放模式时自动清除控制台。                                                                                                                                                                                                  |
|                      | 生成ON清除除      | 版本Project控制台台。                                                                                                                                                                                                     |
|                      | 重新编译编译ON清除除  | 重新编译Project控制台台。                                                                                                                                                                                                   |
| **折叠**               |              | 仅显示重复报错消息的第一个实例。这对于运行时错误（例如 null 引用）很有用，这些错误有时会在每次帧更新 ON 时产生。                                                                                                                                                      |
| **错误暂停**             |              | 每当从脚本调用[`Debug.LogError`](/engine/6000.0/script-reference/unityengine/debug/logerror.md)时暂停播放。使用此属性可以在执行中的指定的点结播放并检查Scene。从脚本调用[`Debug.Log`](/engine/6000.0/script-reference/unityengine/debug/log.md)时，此选项不会暂停播放。 |
| **Attach-to Player** |              | 打开一个下拉菜单，其中包含用于连接到远程 Devices 上运行的 Development 版本以及在控制台中显示 Player 日志的选项。选项项标有Target开发版的Name（这是在 控制台窗口中显示的日志版本）。如果控制台未连接到远程版本，则会将其标记为 **Editor** 以显示控制台窗口中显示的日志来自本地 Unity Editor。                                    |
|                      | Player 日志记录  | 如果控制台连接到远程开发版，则会启用版本的 Player 日志记录。禁用此选项会暂停日志记录，但控制台仍然连接到 Target 版本。禁用此选项还会隐藏下拉菜单菜单单中的REST选项。选择 **Player Logging** 下面列出的任何版本以在控制台窗口中显示其日志。                                                                          |
|                      | Editor       | 如果控制台连接到远程**开发版**，请选择此选项以显示本地 Unity Player 的日志而不是远程版本的日志。                                                                                                                                                          |
|                      | `<Enter IP>` | 打开 **进入 Player IP** 对话框，您可以在其中指定 ON 远程设备的开发版的 IP 地址。要连接到版本，请在对话框中选择 **Connect**，然后将其添加到下拉菜单底部的 Development 版本列表中。                                                                                                  |
|                      | \[开发构建]      | 列出可用的 Development 版本。这包括自动检测的构建以及使用 **Enter IP** 选项添加的构建。                                                                                                                                                          |

## 搜索和过滤控制台输出

您可以从控制台台search栏中search控制台消息中的指定的关键字。类型search术语时，控制台台会过滤消息以仅显示包含匹配文本的消息。控制台仅突出显示 message 文本中的第一个 Match，并且仅当它位于 message 的可见部分时（请参阅下面的[调整线数量](#line-count)）。


**Searching for the term “name” highlights the first match in each message:**
![](/api/media?file=/engine/6000.0/media/images/ConsoleSearch.png)

您可以搜索 Any Console message 中显示的任何内容，包括数字和特殊角色。例如，您可以search控制台台记录message的时间。

search 会查找您在 search 栏中键入的任何类型的精确匹配项。不能同时search两个不同的词，也不能使用通用search引擎运算符。

还可以按类型过滤器控制台消息。单击 search 栏旁边的按钮进行切换：

| **按钮**                                                                                                          | **函数**                  |
| --------------------------------------------------------------------------------------------------------------- | ----------------------- |
| &#xA;**Messages switch:**&#xA;![](/api/media?file=/engine/6000.0/media/images/ConsoleFilterMessage.png)**消息切换** | 显示控制台中的消息数量。单击可显示或隐藏消息。 |
| &#xA;**Warnings switch:**&#xA;![](/api/media?file=/engine/6000.0/media/images/ConsoleFilterWarning.png)**警告切换** | 显示控制台中的警告数量。单击可显示或隐藏警告。 |
| &#xA;**Errors switch:**&#xA;![](/api/media?file=/engine/6000.0/media/images/ConsoleFilterError.png)**错误切换**     | 显示控制台中的错误数量。单击可显示或隐藏错误。 |

## 调整线数量

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

要控制每个入口在列表中可见的行数，请单击控制台菜单按钮，然后从菜单中选择 **日志入口** > **\[X] 行**，其中 **X** 表示要为每个入口显示的行数。


**Log entry line count:**
![](/api/media?file=/engine/6000.0/media/images/ConsoleAdjustLineCount.png)

线数量越大，显示每个条目的文本越多，但会减少 Any 给定时间可见的条目数量。数量不会影响控制台台search函数，该功能始终搜索完整的message文本。如果匹配的文本位ON隐藏线，则search会在结果中返回message，但不会将其Expand以显示或突出显示匹配的文本。您可以在细节区域中看到完整的 message 文本，但匹配的文本不会突出显示。

## stack trace日志记录##stack-trace-logging

Unity 控制台 消息和日志文件可以包括Detailed的stack trace信息。您可以使用 [Stack trace logging](/engine/6000.0/manual/scripting/debugging-and-diagnostics/stack-trace.md) Settings 来控制 stack trace 信息的 amount。

## 从控制台打开日志文件

Unity 或代码写入控制台窗口的所有内容也会写入[日志文件](/engine/6000.0/manual/scripting/debugging-and-diagnostics/log-files.md)。您可以从 控制台窗口菜单中Open日志文件。选择 **Open Player Log** （打开玩家日志）或 **Open Editor Log**（打开编辑器日志）。
