ppm文件格式极其简单，p6二进制格式只需正确文件头（p6\n宽 高\n255\n）和按r-g-b顺序排列的连续rgb字节流；ofstream须以ios::binary打开，避免换行符错误，且需注意bgr转rgb。
PPM 文件格式到底有多简单
PPM（Portable Pixmap）不是“图片格式里的 Hello World”，它就是纯文本定义的像素阵列——没有压缩、不依赖编解码器、连调色板都不需要。你写进去什么 RGB 值，打开就看到什么颜色，前提是顺序对、换行对、头信息对。
关键判断：只要数组是连续的 unsigned char* 类型、按 R-G-B-R-G-B… 排列，且宽高已知，就能直接写出可被 GIMP / ImageMagick / VSCode 插件识别的 PPM 文件。
用 ofstream 写二进制 PPM（P6 格式）最稳
别碰 P3（ASCII）格式——它把每个字节转成字符串再写，慢、大、易错（比如空格/换行多一个就解析失败）。P6 是二进制，只写原始字节，和内存布局完全一致，C++ 写起来最直觉。
-
ofstream必须用ios::binary打开，否则 Windows 下会把\n换成\r\n，破坏二进制结构 - 文件头三行必须是：
P6\n<width><height>\n255\n</height></width>，注意每行末尾是\n（不是\r\n），且第三行只有255和换行，不能有多余空格 - RGB 数据必须严格按行优先、R-G-B 顺序写入；如果原数组是 BGR（如 OpenCV 默认），得手动重排或用
std::swap交换字节
示例片段：
ofstream f("out.ppm", ios::binary);
f (rgb_data), width * height * 3);
常见错误：头信息错位、字节序混乱、路径没权限
这些错误不会报 C++ 异常，但生成的 .ppm 文件打不开，或显示为全黑/错色块。
- 头里写了
P6 \n（多了空格）→ ImageMagick 报错：Invalid ppm file: invalid magic number - 忘了
255\n这一行 → 大部分查看器认为数据缺失，直接拒绝加载 - 用
char*指向int数组（比如误把int rgb[100]当作unsigned char写）→ 实际写入的是 4 字节整数的低字节，颜色全乱 - 路径含中文或空格，又没加引号 →
ofstream构造失败，f.is_open()返回 false，但没人检查
为什么不用 stb_image 或 OpenCV
因为它们太重了：stb_image_write.h 要额外 include + define 宏；OpenCV 需链接库、初始化、处理 Mat header。而纯 PPM 只要 10 行代码、零依赖、无编译选项干扰。
适用场景很窄但明确：调试图像处理中间结果、嵌入式日志截图、教学演示像素级操作。一旦需要 alpha、压缩、YUV、EXIF，立刻切到专业库——PPM 不该被当通用方案用。
最容易被忽略的一点：PPM 文件头中的宽度和高度必须与实际写入的字节数匹配。写 100×100 的图，却在头里写 100 99，ImageMagick 会读出 99 行后截断，最后一行丢掉——这种错根本不会报错，只会静默损坏。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
