C++ 目錄遍歷實戰：MFC CFileFind 遞迴掃描、專案設定與 Unicode/多位元組相容

VC++ 專案需遍歷目錄樹時，MFC `CFileFind` 提供便利封裝。本文涵蓋專案屬性設定、標頭檔引用、遞迴掃描完整程式碼、關鍵 API (`FindFile`/`FindNextFile`/`IsDirectory`/`IsDots`)、多位元組/Unicode 相容宏 (`_T`, `LPCTSTR`)、`TRACE` 除錯輸出與常見錯誤。

專案設定 (必要步驟)

1. 專案屬性 → 一般 → 使用 MFC：選「在共用 DLL 中使用 MFC」或「在靜態程式庫中使用 MFC」。
2. 標頭檔引用：`#include ` (或 `stdafx.h` 已包含)。
3. 字元集設定：屬性 → 進階 → 字元集：建議「使用多位元組字元集」 (MBCS) 以簡化 `_T`/`LPCTSTR` 轉換，或統一 Unicode 並嚴格使用 `CString`/`TCHAR`。

遞迴遍歷標準程式碼 (Microsoft 範例改良)

#include 
#include 

void Recurse(LPCTSTR path) {
    CFileFind finder;
    CString wildcard(path);
    wildcard += _T("\\*.*");  // _T 宏適配 MBCS/Unicode

    BOOL working = finder.FindFile(wildcard);
    while (working) {
        working = finder.FindNextFile();  // 必須先呼叫 FindNextFile 再存取其他屬性

        if (finder.IsDots()) continue;    // 跳過 "." 與 ".."

        if (finder.IsDirectory()) {
            CString fullPath = finder.GetFilePath();
            TRACE(_T("%s\n"), (LPCTSTR)fullPath);  // Debug 輸出
            std::wcout << fullPath.GetString() << std::endl;  // 主控台輸出 (Unicode)
            Recurse(fullPath);  // 遞迴
        }
        // 檔案處理可在這裡加入
        // else { ... finder.GetFileName() ... }
    }
    finder.Close();
}

int main() {
    Recurse(_T("C:\\"));  // 從 C 槽根目錄開始 (需權限)
    return 0;
}

關鍵 API 與流程解析

`TRACE` 宏說明

• Debug 建置輸出至 **Visual Studio 輸出視窗**。
• Release 建置**自動編譯為空操作** (零開銷)。
• 格式類 `printf`：`TRACE(_T("File: %s, Size: %llu\n"), name, size);`。

Unicode / MBCS 相容撰寫技巧

• 字串常值加 `_T("...")` 或 `TEXT("...")`。
• API 使用 `LPCTSTR` / `LPTSTR` / `CString`。
• 主控台輸出 Unicode 用 `std::wcout` + `CString::GetString()`。
• 檔案 I/O 需注意編碼：`CStdioFile` 文字模式自動處理，二進位用 `CFile::modeBinary`。

現代 C++ 替代方案 (C++17 ``)

#include 
#include 
namespace fs = std::filesystem;

void scan(const fs::path& root) {
    for (auto& entry : fs::recursive_directory_iterator(root)) {
        if (entry.is_directory()) {
            std::cout << "[DIR]  " << entry.path() << '\n';
        } else {
            std::cout << "[FILE] " << entry.path() << " (" << entry.file_size() << " bytes)\n";
        }
    }
}

優勢：標準庫、跨平台、無 MFC 相依、支援迭代器範圍 for、錯誤處理用 `std::error_code` 避免例外。

常見錯誤與排查

既有 MFC 專案用 `CFileFind` 最便利；新專案或跨平台需求**強烈建議 C++17 ``**。

1. 上一篇文章： C++ 取得系統當前時間完整指南：C 標準庫 time.h、Windows API GetLocalTime、格式化輸出與精度選擇
2. 下一篇文章： Hibernate 緩存機制深度解析：一級/二級/查詢緩存、N+1 問題根因與解決方案完整實戰

更多程式設計知識

C# Web 訪問 MySQL 三大方案對比：Connector/NET、Web.config、ODBC 全場景指南

ASP.NET 應用連接 MySQL 有多種成熟方案，各有適

Bash shift 指令詳解：優雅處理不定數量參數

核心概念 $#：參數個數 $@ / $*：所有參數

VBScript 提取狗狗影視 ED2K 連結實戰：HTTP 抓取、正則解析與批次導出

針對特定影視聚合站點（狗狗影視）的 ED2K 連結被前端遮罩

C# 多線程實戰：子線程安全刷新 UI 主線程完整範例

WinForms 中直接在子線程操作 UI 控件會拋出異常，