Visual C++ 專案管理：#include vs FileView 添加檔案的差異與 ClassView 精簡技巧

兩種「加入檔案」的本質差異

為什麼 ClassView 會變臃腫？

VC 解析專案中**所有列在 FileView 的 .h 檔案**，將其中的 class/struct/union 全部載入 ClassView 樹狀圖。大型專案若將數百個內部頭文件加入專案，ClassView 會變得極難導航。

精簡 ClassView 的正確做法

1. .cpp 必須加入專案：建置系統需要知道編譯哪些翻譯單元，產出 .obj 供連結器連結。
2. .h 通常不需加入專案：透過 #include 由 .cpp 引入即可；編譯器會自動尋找（專案目錄、Include 路徑）。
3. 例外：資源標頭 resource.h、stdafx.h 等若被資源編譯器/預編譯頭直接引用，可保留在專案中。

操作步驟

# 1. 移除不必要的 .h
在 FileView 中選中 .h → 右鍵 Remove (不刪除檔案，只移出專案)

# 2. 確認 .cpp 都在專案中
FileView → Source Files → 右鍵 Add Files → 選擇所有 .cpp

# 3. 設定 Include 路徑 (若 .h 不在專案目錄)
Project → Settings → C/C++ → Preprocessor → Additional include directories
加入 .h 所在目錄

驗證成效

• ClassView 僅顯示核心業務類別，不再充斥內部實現細節結構體。
• 編譯速度無影響（.h 仍被 .cpp 包含編譯）。
• 專案檔 .dsp/.vcxproj 變小、版控差異減少。

現代 CMake/MSBuild 視角

# CMakeLists.txt
add_executable(MyApp
    src/main.cpp
    src/module.cpp
    # 不需列出 .h
)
target_include_directories(MyApp PRIVATE include)  # .h 所在目錄

現代建置系統**完全不需要**在專案列表出現 .h，僅靠 target_include_directories 指定搜尋路徑。

常見誤區

誤區：「.h 不加入專案會找不到」
事實：#include 走的是編譯器 Include 搜尋路徑，與專案檔案列表無關。

誤區：「ClassView 顯示的類別越多越好」
事實：ClassView 是導航工具，雜訊過多反而降低生產力。