qrencode生成二维码位图数据，stb_image_write将其转为PNG：需将0/1模块数组扩展为RGB三通道（0→255,255,255；1→0,0,0），手动缩放模块尺寸并添加quiet zone边框，严格使用UTF-8输入，确保缓冲区大小为width×height×3且内存布局正确。
用 qrencode 库生成二维码数据，再用 stb_image_write 画成 PNG
纯 C++ 标准库不支持图像编码或二维码生成，必须依赖第三方库。最轻量、无依赖、适合嵌入式或命令行场景的组合是：qrencode（生成 QR 码位图）+ stb_image_write（单头文件写 PNG/JPEG）。不用 Qt、OpenCV 这类重型库，编译快、体积小。
常见错误是直接找 “C++ 二维码图片库”，结果引入一堆构建系统或 GUI 依赖。其实你只需要两段内存操作：一段把字符串转成 QR 码的黑白像素矩阵，一段把这矩阵存成图片文件。
-
qrencode的QRcode_encodeString()返回的是QRcode结构体，其中data是按行优先排布的 0/1 字节数组（每个字节代表一个模块，1=黑，0=白） -
stb_image_write.h需要 RGB 或 RGBA 数据；得把二值数据扩成三通道：每个 1 →{0,0,0}，每个 0 →{255,255,255} - 注意
QRcode的width是模块数，不是像素数；若要放大显示（比如每个模块占 4×4 像素），需手动做缩放，不能直接传给stbi_write_png()
怎么控制二维码尺寸和边距（quiet zone）
qrencode 默认 quiet zone 是 4 个模块宽，不可关闭，但可通过参数调整——它实际由 QRencodeMode 和 QR_ECLEVEL 间接影响，真正可控的是输出图像的“模块大小”和“边框像素数”。
- 调用
QRcode_encodeString()前，用QRspec_getWidth()获取原始宽度，再乘上缩放因子（如 8）得到目标图像宽高 - 边框（quiet zone）需手动在生成的像素数组外围补白：分配
(w + 2*border) × (h + 2*border)大小的缓冲区，把 QR 数据居中拷进去 - 别依赖
-s命令行参数（那是 CLI 工具行为），C API 没有等效字段；所有缩放和 padding 必须自己算
中文字符串生成失败或乱码怎么办
qrencode 默认只支持 UTF-8 编码的输入。如果你传的是 GBK 或系统本地编码的 std::string，会生成无效码或崩溃。
- Windows 控制台默认是 GBK，
std::cin读入的中文不是 UTF-8 → 必须先用MultiByteToWideChar()+WideCharToMultiByte(CP_UTF8)转换 - Linux/macOS 一般没问题，但若终端 locale 是
zh_CN.GB2312，也要显式转 UTF-8（可用iconv或 C++20std::text_encoding） - 测试时先用硬编码 UTF-8 字符串验证，例如
"你好"在源文件里保存为 UTF-8（VS Code 默认就是），而不是靠运行时 locale 推断 - 如果内容含 emoji 或生僻汉字，确保用
QR_MODE_8（8-bit binary mode），别用QR_MODE_KANJI（只支持 Shift-JIS）
生成的 PNG 打开是全黑或全白
这不是 qrencode 出错，而是像素数据没对齐或通道顺序反了。最常踩的坑是：stbi_write_png() 要求每行字节数必须是 4 的倍数（对齐），而你直接把二值数组当 RGB 写入，没补零也没翻转。
- RGB 缓冲区大小必须是
width × height × 3，且每行末尾无需 padding；但stbi_write_png()内部会自动处理对齐，你只要保证总长度正确即可 - 别把
qrcode->data直接 reinterpret_cast 成unsigned char*传进去——它的布局是 row-major，但每个字节是 1 个模块，不是 1 个像素；你得循环展开 - 检查是否把黑色当成了 0：
qrcode->data[i] == 0表示白模块，应填255,255,255；填反了就全黑 - 调试技巧：先写一个 4×4 的固定数组（比如
{1,0,0,1}），生成小图确认流程通不通
真正麻烦的从来不是“有没有库”，而是模块尺寸、编码转换、内存布局这三处细节对不上——少算一个 border、多转一次编码、错把 width 当像素数，都会导致图片不可读。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
