Unity 日誌文件參考 (Log files reference)

原文: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

 

回到頂部