NSLog 有個惱人的特性:不管在 Debug 還是 Release 版本,它都會老實輸出。這代表正式上線的 App 裡滿滿都是除錯訊息,一方面佔用 I/O 效能,一方面也可能把內部資訊洩漏到 Console 中。DLog 就是為了解決這個問題而設計的巨集。
#ifdef DEBUG
#define DLog(fmt, ...) NSLog((@"%s [Line %d] " fmt), __PRETTY_FUNCTION__, __LINE__, ##__VA_ARGS__);
#else
#define DLog(...)
#endif
#define ALog(fmt, ...) NSLog((@"%s [Line %d] " fmt), __PRETTY_FUNCTION__, __LINE__, ##__VA_ARGS__);
兩個巨集的行為差異:
輸出格式類似這樣:
-[MyViewController viewDidLoad] [Line 42] 這裡是要輸出的內容
方法名與行號這兩個資訊在除錯時價值極高——不必插入斷點、不必猜測是哪個檔案的哪一行,Console 直接告訴你。
DLog 生效的前提是專案有定義 DEBUG 巨集。設定路徑是 Target → Build Settings → Preprocessor Macros,在 Debug 這組組態中加入 DEBUG=1。多數 Xcode 專案範本預設已經幫你設好,但既有專案或手動建立的 target 經常漏掉這一項,導致 DLog 完全不輸出。

__PRETTY_FUNCTION__ 會展開成當前函式的完整簽名,在 Objective-C 中就是 -[ClassName methodName] 這樣的形式,比 C 語言的 __FUNCTION__ 資訊更豐富。
##__VA_ARGS__ 中的 ## 是 GCC 的延伸語法,作用是「當變數參數為空時自動吃掉前面的逗號」。少了它,呼叫 DLog(@"只有字串") 會因為多出一個逗號而編譯失敗。這是寫可變參數巨集時幾乎必備的技巧。
若想在正式版徹底杜絕日誌的效能成本,可以讓 DLog 在 Release 下直接展開為空(如本例),或改用 os_log/Logger 這類系統日誌框架——它們在未開啟對應的日誌類別時幾乎零成本,且能在正式環境中由開發者動態開啟,比自建巨集靈活得多。
另外提醒:即使日誌在正式版被關閉,也不要在訊息中輸出密碼、token、個資等敏感資料。日誌很容易在無意間被貼到公開的 issue 論壇上,這類事故屢見不鮮。