不能直接用fwrite写裸数据到.bmp文件，因为BMP必须包含BITMAPFILEHEADER（14字节）和BITMAPINFOHEADER（40字节）才能被正确识别；缺一不可，且需确保BGR顺序、行对齐（每行字节数为4的倍数）、图像数据自下而上存储。
为什么不能直接用 fwrite 写裸数据到 .bmp 文件
因为 BMP 是有严格文件头和信息头的格式，不是“RGB 数据拼上去就能打开”。直接写裸数据，Windows 照片查看器会报“不支持的文件格式”或直接空白——它连宽高、位深、是否压缩都不知道。
核心要补全两部分：BITMAPFILEHEADER（14 字节，含文件大小、偏移）和 BITMAPINFOHEADER（40 字节，含宽、高、位数、压缩方式等）。缺一不可。
常见错误：只填了 biWidth 和 biHeight，但忘了 biSizeImage 要对齐到 4 字节边界，或 bfOffBits 算错导致图像数据被头信息覆盖。
怎么手动构造 BMP 头并写入 RGB 数据（24 位无压缩）
假设你有一块内存 rgb_data，按行优先存储，每像素 3 字节（BGR 顺序！BMP 实际存的是 BGR，不是 RGB），宽 width，高 height。注意：BMP 图像数据从下到上存储（即第 0 行是图像最底行），所以如果原始数据是上到下（常见于 OpenCV、libpng 输出），必须翻转行序。
立即学习“C++免费学习笔记（深入）”；
-
biWidth填正数；biHeight填正数表示“自下而上”，填负数表示“自上而下”（Windows 支持，但部分旧工具不认，建议统一用正数 + 手动翻转数据） - 每行字节数 =
width * 3，但必须是 4 的倍数 → 补零字节数 =(4 - (width * 3) % 4) % 4 -
biSizeImage=(width * 3 + padding) * height -
bfOffBits=sizeof(BITMAPFILEHEADER) + sizeof(BITMAPINFOHEADER)（无调色板时） -
bfSize=bfOffBits + biSizeImage
示例关键片段：
BITMAPFILEHEADER bmf = {0};
bmf.bfType = 0x4D42; // "BM"
bmf.bfSize = sizeof(bmf) + sizeof(BITMAPINFOHEADER) + biSizeImage;
bmf.bfOffBits = sizeof(bmf) + sizeof(BITMAPINFOHEADER);
<p>BITMAPINFOHEADER bmi = {0};
bmi.biSize = sizeof(BITMAPINFOHEADER);
bmi.biWidth = width;
bmi.biHeight = height; // 正数 → 数据需为 bottom-up
bmi.biPlanes = 1;
bmi.biBitCount = 24;
bmi.biCompression = BI_RGB;
bmi.biSizeImage = biSizeImage;</p><p>// 写文件
FILE<em> f = fopen("out.bmp", "wb");
fwrite(&bmf, 1, sizeof(bmf), f);
fwrite(&bmi, 1, sizeof(bmi), f);
for (int y = height - 1; y >= 0; y--) { // 翻转：把原数据第0行当底行
fwrite(rgb_data + y </em> width <em> 3, 1, width </em> 3, f);
if (padding) fwrite("\0\0\0", 1, padding, f);
}
fclose(f);</p>遇到“图像颜色发紫/发绿”或“竖线错位”怎么办
大概率是 BGR/RGB 混淆或行对齐出错。BMP 规范要求每个扫描行末尾补 0 到 4 字节对齐，漏补会导致下一行数据整体左移，视觉上就是彩色竖条纹或颜色通道错位。
检查点：
- 确认你写的确实是 BGR：比如纯红像素应写成
\x00\x00\xFF（B=0, G=0, R=255），不是\xFF\x00\x00 - 打印
width * 3 % 4，非 0 就必须补；补的字节数必须严格等于(4 - width*3%4)%4，不能硬写 4 个\0 - 用十六进制编辑器（如 HxD）打开生成的 BMP，跳过前 54 字节，看第 55 字节起是否是预期的 BGR 值（例如一张全红图，应该看到大量
00 00 FF重复）
更省事但可控性低的方式：用 stb_image_write.h
如果你只是想快速保存、不纠结头结构细节，stb_image_write 是极简选择：单头文件、无依赖、自动处理 BGR 转换、对齐、头填充。但它默认把输入当作 RGB，内部转成 BGR 再写，所以传入前得自己确保顺序正确（或用它提供的 stbi_write_bmp 接口）。
用法示意：
#define STB_IMAGE_WRITE_IMPLEMENTATION
#include "stb_image_write.h"
<p>// 注意：stbi_write_bmp 期望输入是 RGB，它会自动转 BGR 并补 0
stbi_write_bmp("out.bmp", width, height, 3, rgb_data); // 这里 rgb_data 是 RGB 顺序</p>缺点：无法控制 biHeight 符号、不支持 32 位带 alpha（BMP 的 32 位需带掩码且兼容性差），调试时看不到中间过程。
真正容易被忽略的点：BMP 的“像素原点在左下角”是规范强制行为，不是可选项；哪怕你用负高度声称“top-down”，某些图像库（如 Python PIL）读出来仍是反的——最稳方案永远是写正高度 + 自己翻转数据行。
