# 日志文件参考

> Locate Unity's log files which record messages, warnings, and errors that can help you understand the source of problems in your application.

Unity 为编辑器、Package Manager、许可、开发播放器和 Hub 生成日志文件。借助这些日志文件，您可以了解应用程序中发生任何问题的位置。

Unity 会将[控制台 (Console) 窗口](/engine/6000.0/manual/unity-editor/using-the-editor/console.md)中的所有消息、警告和错误添加到日志文件中。如要将自己的消息添加到控制台 (Console) 窗口和日志，请使用 [Debug 类](/engine/6000.0/manual/scripting/debugging-and-diagnostics/class-debug.md)。

不同操作系统存储日志文件的位置不同。此页面列出了默认存储位置，但也可以使用某些命令行参数来控制来控制 Unity 生成日志文件的时间和位置。有关更多信息，请参阅[命令行参数](/engine/6000.0/manual/unity-editor/editor-features/command-line-arguments/editor.md)文档。

\*\*注意：\*\*并非所有平台都支持这项功能。请参阅[针对具体平台的](/engine/6000.0/manual/platform-specific.md)文档以了解更多信息。

## 与编辑器相关的日志位置##editor-related-log-locations

您可以从控制台窗口访问编辑器日志。为此，请打开控制台窗口（**菜单：窗口 (Window)> 常规 (General)> 控制台 (Console)**），然后在控制台窗口菜单中选择**打开编辑器日志 (Open Editor Log)**。

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

### Linux##linux

| **日志类型**            | **日志位置**                                               |
| ------------------- | ------------------------------------------------------ |
| **编辑器**             | `~/.config/unity3d/Editor.log`                         |
| **Package Manager** | `~/.config/unity3d/upm.log`                            |
| **许可客户端**           | `~/.config/unity3d/Unity/Unity.Licensing.Client.log`   |
| **许可审核**            | `~/.config/unity3d/Unity/Unity.Entitlements.Audit.log` |

### macOS##macos

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

| **日志类型**            | **日志位置**                                            |
| ------------------- | --------------------------------------------------- |
| **编辑器**             | `~/Library/Logs/Unity/Editor.log`                   |
| **Package Manager** | `~/Library/Logs/Unity/upm.log`                      |
| **许可客户端**           | `~/Library/Logs/Unity/Unity.Licensing.Client.log`   |
| **许可审核**            | `~/Library/Logs/Unity/Unity.Entitlements.Audit.log` |

### Windows##windows

在 Windows 上，Package Manager 和编辑器的日志放置在默认情况下未在 Windows 资源管理器中显示的文件夹中。要查看 AppData 文件夹，必须在 Windows 上启用隐藏项目 (Hidden Items) 设置。有关如何执行此操作的更多信息，请参阅 Microsoft 关于[在 Windows 中查看隐藏文件和文件夹](https://support.microsoft.com/en-us/windows/view-hidden-files-and-folders-in-windows-97fbc472-c603-9d90-91d0-1166d1d9f4b5)的文档。

在 Windows 上，默认情况下不存在标准输出流，因此必须使用已配置的有效 `stdout` 流来启动编辑器，就像 CI 系统中的子进程一样。如果指定 `-` 以将输出` `发送到 `stdout`，那么在控制台窗口中将看不到输出。

| **日志类型**            | **日志位置**                                                                                      |
| ------------------- | --------------------------------------------------------------------------------------------- |
| **编辑器**             | `%LOCALAPPDATA%\Unity\Editor\Editor.log`                                                      |
| **Package Manager** | 用户帐户：`%LOCALAPPDATA%\Unity\Editor\upm.log`系统帐户：`%ALLUSERSPROFILE%\Unity\Editor\upm.log`       |
| **许可客户端**           | `%LOCALAPPDATA%\Unity\Unity.Licensing.Client.log`                                             |
| **许可审核**            | `%LOCALAPPDATA%\Unity\Unity.Entitlements.Audit.log`                                           |
| **崩溃文件**            | `%TMP%\CompanyName\ProductName\Crashes`\*\*注意：\*\*可使用 `-crash-report-folder` 命令行参数覆盖文件夹位置的位置。 |

## 与播放器相关的日志位置##player-related-log-locations

要查看播放器日志，请打开控制台 (Console) 窗口（**菜单：窗口 (Window)> 常规 (General)> 控制台 (Console)**），然后在控制台窗口菜单中选择**打开播放器日志 (Open Player Log)**。您还可以导航到以下文件夹：

| **操作系统**          | **播放器日志位置**                                                                                                                                                                                                                                                            |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Android**       | 要访问 Android 应用程序的播放器日志，请使用 [Android logcat](https://developer.android.com/studio/command-line/logcat)。有关更多信息，请参阅[查看 Android 日志](/engine/6000.0/manual/platform-specific/android/developing/testing-and-debugging/debugging-on-an-android-device.md#view-android-logs)。 |
| **iOS**           | 可以使用 GDB 控制台，或者通过 XCode 中的管理器控制台来访问 iOS 设备的日志。有关设备日志的更多信息，请参阅 [Apple 文档](https://developer.apple.com/documentation/xcode/acquiring-crash-reports-and-diagnostic-logs)。                                                                                                 |
| **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`                                                                                                                                                                                         |
| **Web**           | Unity 会将日志输出写入到[浏览器的 JavaScript 控制台](/engine/6000.0/manual/platform-specific/webgl/develop/debugging.md)。                                                                                                                                                              |
| **Windows**       | `%USERPROFILE%\AppData\LocalLow\CompanyName\ProductName\Player.log`                                                                                                                                                                                                    |

## Unity Hub 日志位置##unity-hub-log-locations

您可以使用操作系统的文件管理器应用程序访问 Hub 日志。您还可以从 Hub 中访问这些日志。有关更多信息，请参阅 [Hub 文档](https://docs.unity3d.com/hub/manual/Help.html)。

| **操作系统**    | **播放器日志位置**                                                  |
| ----------- | ------------------------------------------------------------ |
| **Linux**   | `~/.config/UnityHub/logs/info-log.json`                      |
| **macOS**   | `~/Library/Application\ Support/UnityHub/logs/info-log.json` |
| **Windows** | `%UserProfile%\AppData\Roaming\UnityHub\logs\info-log.json`  |

## 其他资源##additional-resources

* [控制台窗口](/engine/6000.0/manual/unity-editor/using-the-editor/console.md)
* [堆栈跟踪日志记录](/engine/6000.0/manual/scripting/debugging-and-diagnostics/stack-trace.md)