Base64解码PDF必须用std::vector存储二进制数据并以std::ios::binary模式写入，禁用std::string和文本流操作；推荐使用OpenSSL或cpp-base64库，同时校验路径与权限。
Base64解码后直接写二进制文件，别用std::string当容器
Base64编码的字符串解码后是原始PDF的二进制数据，不是文本。如果用std::string接收解码结果，再用.c_str()写文件，可能在遇到\0字节时被截断——PDF里大量存在该字节，这是最常踩的坑。
正确做法是用std::vector<unsigned char></unsigned>或std::vector<:byte></:byte>（C++17+）存解码输出，然后以std::ios::binary模式写入文件。
- 解码函数返回类型必须是二进制容器，不能是
std::string（除非你确保它不参与c_str()或data()的隐式文本解释） - 写文件时打开流必须带
std::ios::binary标志，否则Windows下会把\r\n误转换 - 不要对解码后的数据做任何
std::cout <<或printf打印——它不是可打印字符
用openssl/base64.h解码比手写更可靠
自己实现Base64查表解码容易漏掉填充字符=处理、边界对齐、非法字符静默失败等问题。OpenSSL的BIO_f_base64()已稳定使用多年，支持标准和URL安全变种（需手动配置），且能准确报错。
关键点：
立即学习“C++免费学习笔记（深入）”；
- 初始化
BIO *链：内存BIO → base64 BIO → 内存BIO（输出） - 调用
BIO_set_flags(b64_bio, BIO_FLAGS_BASE64_NO_NL)关闭换行符依赖（Base64字符串通常无换行） - 写入输入前确保
BIO_write返回值等于输入长度，否则说明有非法字符 - 解码后用
BIO_get_mem_data取原始指针和长度，别用BIO_read循环读——容易少字节
没装OpenSSL？用C++20 std::base64decode最省事
C++20标准库引入了std::base64decode和std::base64encode，头文件<codecvt>已弃用，实际要用<format>？不对——目前（GCC 13/Clang 16）仍需靠libstdc++/libc++实验性支持，且命名是std::ranges::decode_base64（非标准最终名）。所以现实中最可行的是轻量第三方实现。
推荐用单头库base64.hpp（github.com/ReneNyffenegger/cpp-base64），它：
- 只依赖
<string>和<vector> - 解码函数签名是
std::vector<unsigned char> base64_decode(std::string_view)</unsigned> - 遇到非法字符直接抛
std::invalid_argument，不会静默截断 - 自动处理末尾
=填充，兼容RFC 4648 §4（标准Base64）
写PDF文件时路径和权限错误比解码失败更常见
解码成功但文件为空或打不开？大概率是路径问题。C++里std::ofstream对相对路径按当前工作目录解析，而IDE运行目录、终端cd路径、打包后执行路径往往不一致。
- 写文件前先用
std::filesystem::exists检查目标目录是否存在，不存在就用std::filesystem::create_directories建好 - 避免硬编码路径如
"output.pdf"，改用std::filesystem::current_path() / "out" / "doc.pdf" - 写完立刻用
ofs.close()并检查!ofs——流异常位（failbit/badbit）不抛异常，默认静默失败 - Linux/macOS注意文件扩展名大小写，
"PDF"≠"pdf"，但PDF阅读器通常不敏感；Windows下则完全不敏感
