在接手舊專案時,常會遇到 PrefixHeader.pch file not found 的錯誤。這通常發生在 Xcode 6 之後,因為新建立的工程預設不再自動產生 PCH 檔,但舊專案或某些設定仍可能依賴這個檔案。
PCH 是 precompile header,也就是預先編譯標頭檔。它可以放入多個檔案共同使用的標頭,讓編譯器自動引入,減少重複 import,也能提升編譯效率。
如果專案設定中仍指向某個 PCH 路徑,但實際檔案不存在,就會出現 PrefixHeader.pch file not found。這常見於從舊版 Xcode 專案升級、下載範例專案,或手動調整過 Build Settings 的情況。
在 Xcode 中按下 Command + N,選擇 iOS 的 Other,再建立 PCH File。建立後,在檔案中寫入需要全域引入的標頭。

接著開啟專案設定,找到 Build Settings 中的 Precompile Header 相關選項,把剛剛建立的 PCH 檔路徑填入。注意 Debug 與 Release 兩個組態都要設定,否則不同編譯模式仍可能出錯。

完成設定後,重新編譯即可。若專案不再需要 PCH,也可以移除相關設定,避免不必要的全域依賴。