C/C++ #include 指令進階：嵌入二進制數據文件

大家熟知 #include 用於引入頭文件，但鮮有人知它還可以在編譯期「嵌入任意文件內容」到源碼中。本文演示如何將文本文件轉為十六進制數組並通過 #include 直接編譯進程序。

操作步驟

1. 創建 hello.txt，內容 Hello world!!。
2. 將文本轉換為十六進制 ASCII 碼，保存為 hello.hex，格式如：0x48, 0x65, 0x6C, ...。
3. 在代碼中定義字符數組並包含該文件：

char hex[] = {
    #include "hello.hex"
};

預處理器會將 hello.hex 的內容原樣展開到大括號中，等效於：

char hex[] = {
    0x48, 0x65, 0x6C, 0x6C, 0x6F, 0x20, 0x57, 0x6F, 0x72, 0x6C, 0x64, 0x21, 0x21, 0x0D, 0x0A
};

原理與應用場景

• 原理：#include 在預處理階段將指定文件內容原文插入當前位置，本質是文本替換。
• 應用：嵌入著色器代碼、配置表、二進制資源（圖標、字體）、測試用例數據等，避免運行時讀取文件，生成單一可執行文件，便於分發。

注意事項

• 被包含文件必須是合法的 C/C++ token 序列（如數組初始化列表）。
• 大文件會導致編譯緩慢、目標文件膨脹，權衡使用。
• 若直接包含文本，需手動添加引號和轉義，不如十六進制通用。

總結

#include 不僅是模塊化編程的工具，更是編譯期元編程的強大手段。善用它可以實現「數據即代碼」，簡化資源管理流程。