HEADER_FILE_ONLY

此原始碼檔案是否僅為標頭檔。

原始碼檔案的一個屬性，用於指示原始碼檔案是否為標頭檔且沒有相關聯的實作。 此屬性會根據檔案副檔名自動設定，並由 CMake 用於判斷是否應計算某些相依性資訊。

將此屬性設定為 ON，您可以停用給定原始碼檔案的編譯，即使它應該被編譯，因為它是程式庫/可執行檔原始碼的一部分。

如果您有一些原始碼檔案需要以某種方式預處理，然後透過 add_library() 或 add_executable() 加入這些預處理過的原始碼，這會很有用。 通常，在 IDE 中，不會有原始原始碼的參考，只有這些預處理過的原始碼的參考。 因此，透過將所有原始原始碼檔案的此屬性設定為 ON，然後呼叫 add_library() 或 add_executable() 並傳遞預處理過的原始碼和原始原始碼，或者使用 target_sources() 加入原始原始碼檔案，將完全達到預期的效果，也就是說，原始原始碼檔案將在 IDE 中可見，且不會被建置。