系統的 NSLog 很方便,但在專案規模變大後,單純的文字輸出往往不夠。自訂 NSLog 可以加上時間、檔案名稱、行號與函式名稱,讓除錯更有效率。
正式版本通常不需要這些額外資訊,因此建議用 #if DEBUG 包住自訂巨集,避免影響線上效能與穩定性。
#if DEBUG
#define NSLog(FORMAT, ...) {
NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init];
[dateFormatter setDateFormat:@"HH:mm:ss:SSSSSS"];
NSString *timeString = [dateFormatter stringFromDate:[NSDate date]];
NSString *content = [NSString stringWithFormat:FORMAT, ##__VA_ARGS__];
fprintf(stderr, "time:%s file:%s line:%d func:%s content:%s\n",
[timeString UTF8String],
[[[NSString stringWithUTF8String:__FILE__] lastPathComponent] UTF8String],
__LINE__,
__FUNCTION__,
[content UTF8String]);
}
#else
#define NSLog(FORMAT, ...)
#endif這樣的輸出會包含毫秒時間、所在檔案、程式碼行數與函式名稱,特別適合在多執行緒或事件流程複雜時追蹤問題。
在 Release 版本中,可以將巨集定義為空,讓原本的日誌呼叫不再產生輸出。