xxd -i -c 16 是生成可直接编译C数组最稳方案,但需手动加static const前缀、避免路径转义命名失控,大文件须分块处理,且必须正确定义符号、段和对齐以确保链接与运行正确。

用 xxd 生成 C 数组最稳,但默认格式不直接可用
直接跑 xxd -i file.bin 确实能输出类似 unsigned char file_bin[] = {0x01, 0x02, ...}; 的内容,但它默认把文件名转成下划线标识符(比如 foo_bar_bin),且数组名和长度名耦合(file_bin_len)。如果你要嵌入多个资源、或需控制符号可见性(比如加 static),就得手动改——这不是“可直接编译”的本意。
推荐加参数:
-
xxd -i -c 16 file.bin:每行 16 字节,可读性好,也方便后续 diff - 重定向后用
sed或小脚本补static const前缀(别手改,容易漏) - 注意:
xxd把路径中的/和.全转成_,./data/icon.bin→_data_icon_bin,命名不可控
自己写 C++ 小程序生成,可控性最强但要注意字节序和换行
用 std::ifstream 以 std::ios::binary 打开,逐字节读进 std::vector<uint8_t></uint8_t>,再格式化输出。关键不是“能不能读”,而是输出时的细节:
- 每行不要超过 80 列,否则某些旧编译器(如 Keil ARMCC)报错;
-c 12比-c 16更保险 - 末尾必须有分号,且数组定义后要另起一行写长度(
sizeof(...)不可靠,因为可能被宏或 padding 影响) - 如果 bin 文件含 NUL(
0x00),C 字符串字面量会截断,必须用uint8_t数组,不能用char[] - 别用
std::endl——它强制 flush,生成大文件时明显变慢;用'\n'即可
Python 脚本更灵活,但要注意 Windows 换行和 BOM
用 Python 读二进制、转十六进制字符串、按列排版,比 C++ 快得多。但实际项目中踩过这些坑:
- Windows 上用
open(..., 'rb')没问题,但输出到文件时若用text mode写,可能自动加\r\n或 BOM(尤其 VS Code 默认保存带 UTF-8 BOM),导致编译报invalid preprocessing directive - 用
print(..., file=f, end='')控制换行,别依赖print()默认行为 - 数组名建议从命令行传入(
python bin2c.py firmware.bin --name fw_image),避免从路径解析——路径含空格或特殊字符时正则易崩 - 如果 bin 文件 > 100MB,别一次性
.read(),用iter(lambda: f.read(8192), b'')分块处理
嵌入后编译失败?大概率是链接器没看到定义或段设置不对
生成的 C 文件里只有 const uint8_t my_data[] = {...};,但没声明为 extern,也没告诉链接器这段数据该放哪。常见症状:undefined reference to 'my_data' 或运行时地址错乱。
立即学习“C语言免费学习笔记(深入)”;
- 在头文件中加
extern const uint8_t my_data[];和extern const unsigned int my_data_len;(别用sizeof推导) - 如果要用特定内存段(比如 Flash 中的只读区),得在 C 文件里加 GCC 属性:
__attribute__((section(".fw_blob"))) const uint8_t my_data[] = {...}; - 对应地,链接脚本里必须有
.fw_blob : { *(.fw_blob) },否则段被丢弃 - ARM Cortex-M 项目中,如果 bin 是固件镜像,还要确认是否对齐到 4 字节(
__align(4)),否则某些启动代码 memcpy 失败
xxd(BSD 版),有人用 Linux 的(GNU 版),参数行为略有不同。



















