建立新專案時,你會在 Supporting Files 底下看到一個以 -Prefix.pch 結尾的檔案。pch 是 precompiled header 的縮寫,也就是預編譯標頭檔。
這個檔案用來放置專案中那些「很少被修改」的程式碼,例如常用的框架標頭檔,目的是加快編譯速度。
我們知道,當你修改專案裡某個檔案時,編譯器不會重頭把所有檔案都編一次,只會編譯有改動的部分。但假如 pch 裡的內容被改動了,那麼所有被它包含的檔案都得跟著重新編譯,耗時可觀。所以放進 pch 的,最好是幾乎不變動的標頭檔或預編譯程式碼片段。
新專案產生的 pch 預設內容大致如下:
#import <Availability.h> #ifndef __IPHONE_4_0 #warning "This project uses features only available in iOS SDK 4.0 and later." #endif #ifdef __OBJC__ #import <UIKit/UIKit.h> #import <Foundation/Foundation.h> #endif
專案有 Debug 與 Release 兩種版本。Debug 版本是開發過程中的版本,包含完整的除錯資訊,我們靠 NSLog 印出的日誌判斷哪個方法沒被執行、哪個陣列的值沒取出來。寫到這裡,很多人除錯的第一步其實不是設中斷點,而是先 NSLog 一下。
Release 版本則是發布版本。關掉 NSLog 可以加快執行速度、降低記憶體佔用。但問題來了:一個大型專案裡 NSLog 動輒數百處,難道每次發版都要一行行去註解掉?更何況下個版本(比如 1.2)還得把它們全部還原回來,簡直是惡夢。
這時候就需要巨集指令幫忙了。
#ifdef DEBUG // 除錯階段:正常輸出 #define ZPLog(...) NSLog(__VA_ARGS__) #else // 發布階段:展開為空,等於什麼都不做 #define ZPLog(...) #endif
這段巨集的意思是:如果 DEBUG 為真,就編譯 #ifdef 到 #endif 之間的內容;否則編譯器直接跳過。
那 DEBUG 在哪裡設定?在 Target > Build Settings > Preprocessor Macros > Debug 中,可以看到預設已經有一組 DEBUG=1。

在 application:didFinishLaunchingWithOptions: 中放入一個帶巨集判斷的方法,並用一般 NSLog 做對照:
NSLog(@"%s", __func__); debugMethod();
接著透過 Product --> Edit Scheme 切換建置組態:


把 Build Configuration 設為 Debug 時,兩段訊息都會印出;改成 Release 後,只有原生 NSLog 會顯示,debugMethod() 內的輸出則完全消失。

Run、Test、Profile、Analyze、Archive 這幾個動作都可以依需要選擇 Debug 或 Release 模式執行。
結論很簡單:與其手動維護數百個 NSLog,不如從專案一開始就用自訂巨集統一封裝,把「要不要印」這件事交給編譯組態決定。