Debug.Log 用於列印腳本執行時產生的資訊、警告與錯誤訊息,並存在下列變體:
-
Debug.LogWarning:列印警告訊息。
-
Debug.LogError:列印錯誤訊息。
-
Debug.LogAssertion:列印斷言訊息,斷言僅使用於開發測試階段。觸發時代表腳本發生致命錯誤,應強制中斷執行。與錯誤訊息的差別在於,錯誤訊息可以用於不會嚴重影響腳本運作或存在能夠自動修復的狀況。
Debug.Log 輸出的紀錄會顯示於 Console 面板中,請參考:[Unity] Console 面板。
基礎語法
直接輸入字串、數值或任何物件作為參數。
Debug.Log("Test");
Debug.LogWarning("Test");
Debug.LogError("Test");
Debug.LogAssertion("Test");
進階語法一
於字串雙引號前加入 $ 符號,並於字串中使用大括號並輸入欲列印資料。
var minute = System.DateTime.Now.Minute;
var second = System.DateTime.Now.Second;
Debug.Log($"Time - {minute}:{second}");
Debug.LogWarning($"Time - {minute}:{second}");
Debug.LogError($"Time - {minute}:{second}");
Debug.LogAssertion($"Time - {minute}:{second}");
進階語法二
使用 Format 變體來組合參數至字串,於字串中使用大括號並標記編號,並於第二參數開始輸入參數 (編號對應參數順序,編號應從 0 開始標記)。
var minute = System.DateTime.Now.Minute;
var second = System.DateTime.Now.Second;
Debug.LogFormat("Time - {0}:{1}", minute, second);
Debug.LogWarningFormat("Time - {0}:{1}", minute, second);
Debug.LogErrorFormat("Time - {0}:{1}", minute, second);
Debug.LogAssertionFormat("Time - {0}:{1}", minute, second);
進階語法三
Debug.Log 支援 Rich Text,可以控制紀錄的字型大小、顏色等屬性,使用 XML 進行標記。
// 粗體
Debug.Log("<b>Test</b>");
// 斜體
Debug.Log("<i>Test</i>");
// 大小
Debug.Log("<size=23>Test</size>");
// 顏色
Debug.Log("<color=#ff000077>Test</color>");
執行結果: