Linux/macOS下静态资源需用xxd -i转为C++数组编译进二进制，Windows用.rc资源脚本，跨平台推荐CMake自动化生成；注意const声明、链接属性、资源ID类型及防止优化丢弃。
静态资源怎么嵌入可执行文件（Linux/macOS）
不能直接“打包”，但可以转成 C++ 数组编译进二进制。核心思路是：把图片、JSON、HTML 等文件用 xxd -i（Linux/macOS）或 bin2c 工具转为 unsigned char 数组，再声明为 extern const 在代码里引用。
常见错误是忘记加 const 或没设链接属性，导致链接时找不到符号；还有人误以为 xxd -i 生成的数组名能直接当路径用——它只是内存块，没有文件系统语义。
-
xxd -i logo.png > logo.h生成unsigned char logo_png[]和unsigned int logo_png_len - 在源文件中
#include "logo.h"，然后用std::string_view(logo_png, logo_png_len)构造只读视图 - 确保构建系统（如 CMake）把生成的
.h文件加入依赖，否则改资源后不自动重编译
Windows 下用 RC 资源脚本嵌入（.rc 方式）
Windows 原生支持资源段（.rsrc），比转数组更规范，也兼容 Win32 API 的 FindResource/LoadResource。但 C++ 标准库不识别它，必须调用 Windows API 手动提取。
容易踩的坑：资源 ID 写错类型（比如把 RT_RCDATA 写成 RT_BITMAP）、没用 MAKEINTRESOURCE 宏、或者忘了调用 LockResource 就直接用指针。
立即学习“C++免费学习笔记（深入）”；
- 写
resource.rc：MY_DATA RCDATA "config.json" - 在 CMake 中用
add_executable(... WIN32)并调用set_source_files_properties(resource.rc PROPERTIES LANGUAGE RC) - 运行时用
HRSRC h = FindResource(nullptr, MAKEINTRESOURCE(IDR_MY_DATA), RT_RCDATA)获取句柄
跨平台方案：CMake 自动化资源嵌入（推荐）
手动跑 xxd 或维护 .rc 很容易漏掉更新。用 CMake 的 configure_file + 自定义命令，能实现“改资源就重生成数组头文件”。关键是让 CMake 知道资源文件是源输入，不是普通数据文件。
性能上无额外开销（全在编译期完成），但要注意：生成的头文件默认不参与 IDE 的语法索引，可能影响跳转和补全；另外，大文件（>10MB）会让编译器内存占用明显升高。
- 用
add_custom_command调xxd -i，输出到${CMAKE_CURRENT_BINARY_DIR}/res_logo.h - 用
target_sources(${target} PRIVATE ${CMAKE_CURRENT_BINARY_DIR}/res_logo.h)告诉编译器这是源 - 避免硬编码路径：用
$<target_file_dir:></target_file_dir:>在运行时定位自身模块基址（仅 Windows/Linux 可行）
运行时如何安全访问嵌入资源
别假设资源一定在内存里连续加载——尤其是用 .rc 或不同链接器（lld vs ld.gold）时，段对齐、重定位都可能影响地址计算。最稳妥的方式是统一走抽象层，比如封装一个 get_embedded_resource("config.json") 返回 std::span<const std::byte></const>。
容易被忽略的一点：调试时想看嵌入内容，得用 objdump -s（Linux）或 dumpbin /resource（Windows）查原始字节，IDE 的变量窗口看不到这些数组——它们不在符号表里，只是未初始化数据段的一部分。
- 不要用
reinterpret_cast<char>(logo_png)</char>直接当 C 字符串用（缺少结尾\0） - 如果资源需多次读取，缓存
std::span比每次都重新获取长度安全 - Release 模式下链接器可能丢弃未引用的资源数组，加
__attribute__((used))（GCC/Clang）或[[used]]（C++17）防止优化掉
