包含此页的版本:
不含此页的版本:
Unity 为编辑器、包管理器、许可、开发播放器和 Hub 生成日志文件。您可以使用这些日志文件来了解应用程序中发生任何问题的位置。
Unity 会从控制台窗口Unity 编辑器窗口,显示 Unity 或您自己的脚本生成的错误、警告和其他消息。更多信息
请参阅术语表到日志文件。要将自己的消息添加到控制台窗口和日志,请使用 Debug 类。
每个作系统将日志文件存储在不同的位置。此页面概述了默认位置,但您也可以使用某些命令行参数来控制 Unity 生成日志文件的时间和位置。有关详细信息,请参阅命令行参数文档。
你可以在项目代码中使用 Application.consoleLogPath 属性来获取当前正在运行的编辑器或播放器应用程序的日志位置。
注意:并非所有平台都支持此功能。有关详细信息,请参阅平台开发。
你可以从控制台窗口访问编辑器日志。为此,请打开 控制台窗口(主菜单:窗口>常规>控制台),然后从 控制台(Console) 窗口菜单中选择 打开编辑器日志(Open Editor Log)。
您可以使用作系统的文件管理器应用程序访问其他日志。
| 日志类型 | 日志位置 |
|---|---|
| 编辑 器 | ~/.config/unity3d/Editor.log |
| 包管理器 | ~/.config/unity3d/upm.log |
| 许可客户端 | ~/.config/unity3d/Unity/Unity.Licensing.Client.log |
| 许可审核 | ~/.config/unity3d/Unity/Unity.Entitlements.Audit.log |
在 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 上播放器崩溃文件的位置,请参阅CrashReporting.crashReportFolder.
您可以使用作系统的文件管理器应用程序访问 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 |