原文:Unity - Manual: Log files reference
日誌檔案參考資料
Unity 會產生用於編輯器、套件管理器、授權、開發版玩家(Development Players)以及 Unity Hub 的日誌檔案。這些日誌檔案可協助您了解應用程式中發生問題的位置。
Unity 會將所有來自「主控台視窗」的訊息、警告與錯誤記錄到日誌檔案中。若您希望將自訂訊息加入主控台與日誌中,可使用 Debug
類別。
不同作業系統會將日誌檔案儲存在不同位置。本文列出預設儲存位置,您也可以透過命令列參數來控制 Unity 產生日誌檔案的時間與位置。詳情請參閱 命令列參數說明文件。
您可以在專案程式碼中使用 Application.consoleLogPath
屬性來取得目前執行中的編輯器或玩家應用程式的日誌位置。
注意:並非所有平台都支援此功能。詳情請參閱平台開發相關文件。
編輯器相關日誌位置
您可以透過 Unity 編輯器的主控台視窗存取編輯器日誌。請依以下步驟操作:
開啟主控台視窗(選單:Window > General > 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 資料夾。詳情請參閱 Microsoft 文件:在 Windows 中檢視隱藏檔案與資料夾。
此外,Windows 預設不支援標準輸出串流(stdout),若要使用,需透過 CI 系統以子程序方式啟動編輯器並設定有效的 stdout
串流。若指定 -
將輸出導向 to
stdout,則主控台視窗將不會顯示輸出內容。
日誌類型 |
儲存位置 |
編輯器 |
%LOCALAPPDATA%\Unity\Editor\Editor.log |
套件管理器 |
使用者帳號:%LOCALAPPDATA%\Unity\Editor\upm.log
SYSTEM 帳號:%ALLUSERSPROFILE%\Unity\Editor\upm.log |
授權用戶端 |
%LOCALAPPDATA%\Unity\Unity.Licensing.Client.log |
授權稽核 |
%LOCALAPPDATA%\Unity\Unity.Entitlements.Audit.log |
當機檔案 |
%TMP%\Unity\Editor\Crashes |
注意:您可以使用 -crash-report-folder
命令列參數來覆寫當機報告的儲存位置。
玩家相關日誌位置
若要檢視玩家日誌,請開啟主控台視窗(選單:Window > General > Console),然後選擇 Open Player Log。您也可以直接前往以下資料夾:
各作業系統玩家日誌位置
作業系統 |
玩家日誌位置 |
Android |
使用 Android Logcat 工具。詳情請參閱 檢視 Android 日誌。 |
iOS |
使用 GDB 主控台或透過 Xcode 的 Organizer Console 存取。詳情請參閱 Apple 的相關文件。 |
Linux |
~/.config/unity3d/CompanyName/ProductName/Player.log |
macOS |
~/Library/Logs/Company Name/Product Name/Player.log
也可使用 Console.app 工具尋找日誌檔案。 |
通用 Windows 平台(UWP) |
%USERPROFILE%\AppData\Local\Packages\<productname>\TempState\UnityPlayer.log |
Web |
Unity 會將日誌輸出寫入瀏覽器的 JavaScript 主控台。 |
Windows |
%USERPROFILE%\AppData\LocalLow\CompanyName\ProductName\Player.log |
玩家當機檔案(僅限 Windows)
Windows 玩家當機檔案的位置請參閱 CrashReporting.crashReportFolder
屬性。
Unity Hub 日誌位置
您可以透過作業系統的檔案總管存取 Unity Hub 的日誌,也可以在 Hub 介面中查看。詳情請參閱 Unity Hub 文件。
作業系統 |
Hub 日誌位置 |
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 |