寫 iOS 的過程中,難免會遇到五花八門的編譯警告:系統 API 被棄用、weak 變數可能提前釋放、循環引用、performSelector 洩漏等等。對有「代碼潔癖」的工程師來說,這些黃色的提示簡直如眼中釘。今天我們就來聊聊如何用 clang 提供的 diagnostic 指令,乾淨俐落地把特定警告關掉。
核心其實只有三個關鍵字:push、ignored、pop。用法如下:
#pragma clang diagnostic push
#pragma clang diagnostic ignored "-Wdeprecated-declarations"
// 在這裡寫會觸發警告的程式碼
#pragma clang diagnostic pop
把容易報警的程式碼夾在中間,編譯器就會對這段區塊睜一隻眼閉一隻眼。以方法棄用為例,加上這段之後,「deprecated」的提示便消失無踪。
關鍵在於每個警告都有一個以 -W 開頭的識別名稱。你可以在下方清單中搜尋對應的警告訊息,把它的代號填進 ignored 後面,再用 push/pop 包住程式碼即可。以下是一些常見的 Semantic、Lexer 與 Parser 警告代號,供查閱:
-Wdeprecated-declarations 使用已棄用的宣告
-Warc-retain-cycles block 中強引用 self 可能造成循環引用
-Warc-repeated-use-of-weak weak 變數可能被多次存取而提前變為 nil
-Warc-unsafe-retained-assign 將物件指派給 weak/unsafe_unretained 屬性會提前釋放
-Warc-performSelector-leaks performSelector 因 selector 未知可能造成洩漏
-Wimplicit-retain-self block 隱式保留 self
-Wundeclared-selector 使用了未宣告的 selector
-Wobjc-missing-super-calls 方法可能缺少 [super ...] 呼叫
-Wunused-variable 未使用的變數
-Wunused-parameter 未使用的參數
-Wunused-function 未使用的函式
-Wunreachable-code 永遠不會被執行的程式碼
-Wshadow-ivar 區域變數遮蔽了實例變數
-Wreceiver-is-weak weak 訊息接收者可能被提前設為 nil
-Wstring-compare 直接比較字串指標結果未定義
-Wtautological-compare 恆真或恆假的比較運算
-Wswitch-enum switch 未完整處理列舉值
完整的 clang 警告清單其實非常龐大,涵蓋 Semantic Warnings、Lexer Warnings、Parser Warnings 三大類,從 ARC 記憶體管理、C++ 相容性、格式字串到執行緒安全分析都有對應代號。實務上最常被處理的,不外乎是棄用 API、循環引用與未使用變數這幾種。掌握 push/ignored/pop 這個組合技,你就能針對性地讓真正重要的警告浮出來,而不再被雜訊淹沒。
小提醒:關閉警告是「治標」,能修復的根因還是要修復。這套指令最適合用在無法改動的第三方程式碼,或系統暫時無法回避的棄用 API 上。