Console 窗口

The Console Window displays errors, warnings, and other messages the Editor generates. These errors and warnings help you find issues in your project, such as script compilation errors. They also alert you to actions the Editor has taken automatically, such as replacing missing meta files, which could cause an issue somewhere else in your project.

To help you debug your project, use the Debug class to print your own messages to the Console. For example, you can print the value of a variable at certain points in your script to see how they change.

This page covers the options you can use when you work with the Console window, and how you can filter your messages by searching for specific keywords.

Console window interface

To open the Console, from Unity’s main menu go to Window > General > Console.

A. The Console toolbar has options for controlling how to display messages, and for searching and filtering messages.

B. The Console window menu has options for opening Log files, controlling how much of each message is visible in the list, and setting stack trace options.

C. The Console list displays an entry for each logged message. Select a message to display its entire text in the detail area. You can choose how many lines of each message to display here. See Adjusting the line count, below.

D. The detail area displays the full text of the selected message. If you enable stack trace, the detail area displays references to specific lines in code files as clickable links.

Console 工具栏选项

The toolbar of the Console window has options for controlling how to display messages, and for searching and filtering messages.

Searching and filtering Console output

You can search Console messages for specific keywords from the Console search bar. As you type a search term, the Console filters messages to display only those that contain matching text. The Console highlights only the first match in the message text, and only if it’s in the visible part of the message (see Adjusting the Line Count below).

You can search for anything that appears in any Console message, including numerals and special characters. For example, you can search for the time the console logged a message.

The search looks for exact matches of whatever you type in the search bar. You can’t search for two different terms at once, or use common search engine operators.

You can also filter Console messages by type. Click the buttons beside the search bar to toggle:

按钮	功能
Messages switch	Displays the number of messages in the Console. Click to display or hide messages.
Warnings switch	Displays the number of warnings in the Console. Click to display or hide warnings.
Errors switch	Displays the number of errors in the Console. Click to display or hide errors.

Adjusting the line count

每个控制台条目的最大长度为 10 行。

To control how many lines of each entry are visible in the list, click the Console menu button, and select Log Entry > [X] Lines from the menu, where [X] is the number of lines to display for each entry.

A larger line count displays more of the text of each entry, but reduces the number of entries visible at any given time. The line count doesn’t affect the Console search function, which always searches the full message text. If the matching text is on a hidden line, the search returns the message in the results, but doesn’t expand it to reveal or highlight the matching text. You can see the full message text in the detail area, but the matching text isn’t highlighted there.

堆栈跟踪日志记录

Unity Console messages and log files can include detailed stack trace information. You can control the amount of stack trace information using the stack trace logging settings.

Opening Log files from the Console

Everything Unity or your code write to the Console Window is also written to a Log File. You can open Log files from the Console window menu. Select Open Player Log or Open Editor Log.