Version: 6000.3
语言: 中文
Debug 类
堆栈跟踪日志记录

日志文件参考

Unity 为编辑器、包管理器、许可、开发播放器和 Hub 生成日志文件。您可以使用这些日志文件来了解应用程序中发生任何问题的位置。

Unity 会从控制台窗口Unity 编辑器窗口,显示 Unity 或您自己的脚本生成的错误、警告和其他消息。更多信息
请参阅术语表
到日志文件。要将自己的消息添加到控制台窗口和日志,请使用 Debug 类

每个作系统将日志文件存储在不同的位置。此页面概述了默认位置,但您也可以使用某些命令行参数来控制 Unity 生成日志文件的时间和位置。有关详细信息,请参阅命令行参数文档。

你可以在项目代码中使用 Application.consoleLogPath 属性来获取当前正在运行的编辑器或播放器应用程序的日志位置。

注意:并非所有平台都支持此功能。有关详细信息,请参阅平台开发

与编辑器相关的日志位置

你可以从控制台窗口访问编辑器日志。为此,请打开 控制台窗口(主菜单:窗口>常规>控制台),然后从 控制台(Console) 窗口菜单中选择 打开编辑器日志(Open Editor Log)。

您可以使用作系统的文件管理器应用程序访问其他日志。

Linux的

日志类型 日志位置
编辑 器 ~/.config/unity3d/Editor.log
包管理器 ~/.config/unity3d/upm.log
许可客户端 ~/.config/unity3d/Unity/Unity.Licensing.Client.log
许可审核 ~/.config/unity3d/Unity/Unity.Entitlements.Audit.log

macOS作系统

在 macOS 上,您还可以通过 Console.app 实用程序访问 Unity 的日志

日志类型 日志位置
编辑 器 ~/Library/Logs/Unity/Editor.log
包管理器 ~/Library/Logs/Unity/upm.log
许可客户端 ~/Library/Logs/Unity/Unity.Licensing.Client.log
许可审核 ~/Library/Logs/Unity/Unity.Entitlements.Audit.log

窗户

在 Windows 上,包管理器和编辑器日志放置在默认情况下不显示在 Windows 资源管理器中的文件夹中。若要查看 AppData 文件夹,必须在 Windows 上启用“隐藏项”设置。有关如何执行此作的详细信息,请参阅 Microsoft 关于在 Windows 中查看隐藏文件和文件夹的文档。

在Windows上,默认情况下不存在标准输出流,因此你必须在启动编辑器时配置有效的stdoutstream,作为 CI 系统的子进程。如果您指定发送输出'-tostdout',则不会在控制台窗口中看到输出。

日志类型 日志位置
编辑 器 %LOCALAPPDATA%\Unity\Editor\Editor.log
包管理器 用户帐户:%LOCALAPPDATA%\Unity\Editor\upm.log
系统账户:%ALLUSERSPROFILE%\Unity\Editor\upm.log
许可客户端 %LOCALAPPDATA%\Unity\Unity.Licensing.Client.log
许可审核 %LOCALAPPDATA%\Unity\Unity.Entitlements.Audit.log
崩溃文件 %TMP%\Unity\Editor\Crashes

注意:您可以使用-crash-report-folder命令行参数。

与玩家相关的日志位置

要查看玩家日志,请打开控制台窗口(主菜单:控制台>>常规窗口),然后从 控制台窗口菜单中选择 打开玩家日志(Open Player Log您还可以导航到以下文件夹:

操作系统 播放器日志由独立播放器创建的.log文件,其中包含事件记录,例如脚本执行时间、编译器版本和 AssetImport 时间。日志文件可以帮助诊断问题。更多信息
请参阅术语表
位置
人造人 要访问 Android 应用程序的播放器日志,请使用 Android logcat。有关详细信息,请参阅查看 Android 日志
iOS系统 使用 GDB 控制台或通过 XCode 的管理器控制台访问 iOS 设备日志。有关设备日志的更多信息,请参阅 Apple 的文档
Linux的 ~/.config/unity3d/CompanyName/ProductName/Player.log
macOS作系统 ~/Library/Logs/Company Name/Product Name/Player.log

注意:您还可以使用 Console.app 实用程序查找日志文件。
通用 Windows 平台 %USERPROFILE%\AppData\Local\Packages\<productname>\TempState\UnityPlayer.log
Unity 将日志输出写入浏览器的 JavaScript 控制台
窗户 %USERPROFILE%\AppData\LocalLow\CompanyName\ProductName\Player.log

播放器崩溃文件(仅限 Windows)

有关 Windows 上播放器崩溃文件的位置,请参阅CrashReporting.crashReportFolder.

Unity Hub 日志位置

您可以使用作系统的文件管理器应用程序访问 Hub 日志。您还可以从 Hub 中访问这些日志。有关详细信息,请参阅 Hub 文档

操作系统 玩家日志位置
Linux的 ~/.config/UnityHub/logs/info-log.json
macOS作系统 ~/Library/Application\ Support/UnityHub/logs/info-log.json
窗户 %UserProfile%\AppData\Roaming\UnityHub\logs\info-log.json

其他资源

Debug 类
堆栈跟踪日志记录