用 std::ifstream 读二进制文件必须加 std::ios::binary 标志，否则 Windows 下会将 \r\n 转为 \n 篡改原始字节；跨平台代码须统一处理，并正确拼接 MIME 类型到 data: URL 中。
用 std::ifstream 读二进制文件时必须加 std::ios::binary
不加这个标志，Windows 下会把 \r\n 自动转成 \n，导致原始字节流被篡改，Base64 编码后解码失败。Linux/macOS 虽然影响小，但跨平台代码必须统一处理。
正确做法是：
std::ifstream file("test.jpg", std::ios::binary | std::ios::ate);
if (!file.is_open()) return;
std::streamsize size = file.tellg();
file.seekg(0, std::ios::beg);
std::vector<char> buffer(size);
file.read(buffer.data(), size);
-
std::ios::ate让文件指针初始位于末尾，方便tellg()获取总长度 - 必须用
vector<char>或std::string（非 null-terminated）存原始字节，不能用 C 风格字符串 -
file.read()不会自动补\0，别假设 buffer 可当 C 字符串用
Base64 编码函数要处理任意长度字节流，不能硬编码图片类型
网上很多示例只支持固定长度或假设输入是 ASCII，但图片是纯二进制，每个字节都可能是 0x00～0xFF。编码逻辑必须严格按 RFC 4648：每 3 字节输入生成 4 字节 Base64 字符，不足则补 =。
一个轻量可靠的实现要点：
立即学习“C++免费学习笔记（深入）”；
const std::string base64_chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
std::string base64_encode(const std::vector<char>& bytes) {
std::string out;
int val = 0, valb = -6;
for (unsigned char c : bytes) {
val = (val << 8) + c;
valb += 8;
while (valb >= 0) {
out.push_back(base64_chars[(val >> valb) & 0x3F]);
valb -= 6;
}
}
if (valb > -6) out.push_back(base64_chars[((val << 8) >> (valb + 8)) & 0x3F]);
while (out.size() % 4) out.push_back('=');
return out;
}
- 别用第三方库（如 OpenSSL）的
BIO_f_base64()—— 它默认启用换行，需额外调用BIO_set_flags(..., BIO_FLAGS_BASE64_NO_NL) - 输出字符串长度一定是 4 的倍数，末尾
=数量只可能是 0、1 或 2 - 如果后续要嵌入 HTML
<img src="data:image/jpeg;base64,...>，记得拼上前缀，但前缀不属于 Base64 编码本身
大文件（>10MB）直接全加载进内存可能触发 OOM
对几十 MB 的 PNG 或 RAW 图，一次性 file.read() 到 vector 容易耗尽内存，尤其在嵌入式或低配环境。实际项目中应分块编码或改用流式处理。
- Base64 编码本身可流式进行：每 3 字节一组输出 4 字符，最后一组不足 3 字节时补
= - 但标准 C++ iostream 没提供“读 n 字节直到满缓冲区”的原子接口，需手动控制
read()返回值 - 更稳妥的做法是限制单次读取大小（如 8192 字节），并确保跨块边界时 3 字节对齐 —— 也就是上一块末尾剩余 1 或 2 字节，要暂存到下一块开头一起编码
- 若只是偶尔处理图片，且确定文件不会超 50MB，全加载反而更简单可靠
Base64 字符串嵌入 HTML 时注意 URL 编码和 MIME 类型匹配
生成的 Base64 字符串本身不含协议头，直接塞进 src 属性会失效。常见错误是写成 "data:base64,xxx"，漏了 MIME 类型。
- 必须写成
"data:image/jpeg;base64,xxx"或"data:image/png;base64,xxx"，类型要跟源文件一致 - 不要对 Base64 字符串做额外 URL 编码（如把
+换成%2B），data:URL 规范明确允许+和/ - Chrome/Firefox 对 MIME 类型宽松，但 Safari 在某些版本会因类型不匹配拒绝渲染
- 如果不确定原图类型，可读文件头判断：
0xFF 0xD8是 JPEG，0x89 0x50 0x4E 0x47是 PNG —— 别依赖扩展名
