Version: Unity 6.0 (6000.0)
语言 : 中文
日志文件参考
Roslyn 分析器和源生成器

堆栈跟踪日志记录

Unity Console 消息和日志文件可以包含详细的堆栈跟踪信息。控制台还会链接到生成消息的代码行。当您想要识别导致日志条目出现的行、方法或函数调用序列,这非常有用。

提示:检查代码的另一种方法是将调试器附加到编辑器或构建的播放器。

托管和非托管代码的堆栈跟踪

Unity 可提供托管和非托管代码的堆栈跟踪信息:

  • 托管代码:在 Unity 中运行的托管 DLL 或 C# 脚本。其中包括 Unity 附带的脚本、您编写的自定义脚本、Asset Store 插件附带的第三方脚本或者引擎中运行的任何其他 C# 脚本。

  • 非托管代码:原生 Unity 引擎代码,或直接在计算机上或目标构建平台上运行的原生插件中的代码。非托管代码通常是从 C 或 C++ 代码编译的。仅当拥有原生二进制文件的原始源代码时才能访问它。通常,仅当需要确定错误源自于您的代码还是引擎代码(以及源自于引擎代码中某个具体的部分)时,才会对非托管代码使用堆栈跟踪。

Unity 提供了三个堆栈跟踪选项:

  • None:Unity 不输出堆栈跟踪信息。
  • ScriptOnly:Unity 仅输出托管代码的堆栈跟踪信息。这是默认选项。
  • Full:Unity 输出托管和非托管代码的堆栈跟踪信息。

堆栈跟踪资源要求

解析堆栈跟踪(特别是整个堆栈跟踪)是一种资源密集型操作。堆栈跟踪的一些最佳做法包括:

  • 仅将堆栈跟踪用于调试。切勿将应用程序部署到启用了堆栈跟踪的用户。
  • 限制显示堆栈跟踪的消息类型。例如,考虑仅对异常和警告使用堆栈跟踪。

设置堆栈跟踪类型

注意:堆栈跟踪选项是一种构建设置,会影响到构建的播放器。它不是编辑器中的视图偏好设置。

要指定堆栈跟踪中所包含的细节量,可以使用脚本 API 或编辑器:

  • 要通过脚本 API 控制堆栈跟踪日志记录,请使用 Application.SetStackTraceLogType。可以使用 API 在播放器构建之前或运行时更改播放器的堆栈跟踪设置。

  • 要使用控制台,请选择控制台 (Console) 菜单按钮,然后:
    • 要为所有控制台消息类型选择相同的堆栈跟踪选项,请选择堆栈跟踪日志记录 (Stack Trace Logging) > 全部 (All)
    • 要仅为其中一种控制台消息类型选择堆栈跟踪选项,请选择堆栈跟踪日志记录 (Stack Trace Logging) > [消息类型] ([MESSAGE TYPE])。使用新设置重新构建播放器。
  • 要使用播放器设置 (Player Settings) 窗口,请选择编辑 (Edit) > 项目设置 (Project Settings) > 播放器 (Player) > 其他设置 (Other Settings)。使用新设置重新构建播放器。

控制台中的堆栈跟踪日志记录选项。以下示例显示了异常 (Exception) 的选项。
控制台中的堆栈跟踪日志记录选项。以下示例显示了异常 (Exception) 的选项。

从堆栈跟踪输出中打开源文件

消息的全文包含对代码文件中特定行的引用以及链接。单击任意链接即可在 IDE 中打开文件并转到引用的行。

查找构建的应用程序的输出日志文件

构建的应用程序不会输出到控制台。要查看堆栈跟踪,请使用应用程序的日志文件

其他资源

日志文件参考
Roslyn 分析器和源生成器