CodeBlocks "no such file or directory" 編譯錯誤完美解決

在 CodeBlocks 中新增自定義頭文件後，明明已加入專案卻編譯報錯 fatal error: xxx.h: No such file or directory。原因在於編譯器不知道頭文件所在目錄，需在專案建置選項中添加搜尋路徑。

解決步驟（圖文並茂）

1. 打開 Project → Build options（專案 → 構建選項）。
2. 選中專案名稱（非 Debug/Release 子項），切換到 Search directories（搜索目錄）標籤。
3. 在 Compiler 分頁點擊 Add，選擇存放頭文件的資料夾（非具體文件），確定。
4. 重新編譯，錯誤消失。

新建類時的關鍵勾選項

使用 File → New → Class 時，必須勾選 Header and implementation file shall be in same folder（頭文件與實現文件放在同一資料夾）。

• 若未勾選，CodeBlocks 會將 #include "MyClass.h" 生成為相對路徑，導致編譯器找不到。
• 勾選後，雙方同目錄，#include "MyClass.h" 即可直接編譯通過，無需寫完整路徑。

原理說明

CodeBlocks 專案樹僅管理文件列表，編譯器實際搜尋頭文件依賴 Compiler search directories。將頭文件所在目錄加入搜尋路徑，等同於在 GCC 中加入 -I/path/to/headers。