Base64 编码解码在 C++ 中无标准库支持,但可使用纯 C++ 实现:编码将每 3 字节转为 4 字符(A–z、0–9、+、/),用 '=' 填充;解码严格校验长度、填充及字符合法性,并支持含空字节和中文的任意二进制数据。

Base64 编码和解码在 C++ 中没有标准库直接支持,但可以用简洁、安全的纯 C++ 实现(无需外部依赖)。下面是一个轻量、跨平台、符合 RFC 4648 的实现,支持任意二进制数据(含空字节、中文等),并附带完整可运行示例。
Base64 编码原理与字符表
Base64 将每 3 字节(24 位)原始数据拆成 4 组 6 位,映射为 64 个可打印 ASCII 字符(A–Z, a–z, 0–9, +, /),末尾用 '=' 补齐。标准字符表固定,不可随意替换:
- A–Z → 0–25
- a–z → 26–51
- 0–9 → 52–61
- + → 62,/ → 63
C++ Base64 编码函数(std::string 输入/输出)
以下函数接受 std::string(可含 '\0'),返回编码后的字符串:
#include#include static const std::string base64_chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
std::string base64_encode(const std::string& input) { std::string output; output.reserve(((input.length() + 2) / 3) * 4); // 预分配空间
size_t i = 0; while (i < input.length()) { unsigned char b0 = input[i++]; unsigned char b1 = (i < input.length()) ? input[i++] : 0; unsigned char b2 = (i < input.length()) ? input[i++] : 0; unsigned char p0 = b0 >> 2; unsigned char p1 = ((b0 & 0x03) << 4) | (b1 >> 4); unsigned char p2 = ((b1 & 0x0f) << 2) | (b2 >> 6); unsigned char p3 = b2 & 0x3f; output.push_back(base64_chars[p0]); output.push_back(base64_chars[p1]); output.push_back((i > input.length() - 2) ? '=' : base64_chars[p2]); output.push_back((i > input.length() - 1) ? '=' : base64_chars[p3]); } return output;}
《PHP设计模式指南》中文版下载《PHP设计模式》首先介绍了设计模式,讲述了设计模式的使用及重要性,并且详细说明了应用设计模式的场合。接下来,本书通过代码示例介绍了许多设计模式。最后,本书通过全面深入的案例分析说明了如何使用设计模式来计划新的应用程序,如何采用PHP语言编写这些模式,以及如何使用书中介绍的设计模式修正和重构已有的代码块。作者采用专业的、便于使用的格式来介绍相关的概念,自学成才的编程人员与经过更多正规培训的编程人员
立即学习“C++免费学习笔记(深入)”;
C++ Base64 解码函数(支持填充,严格校验)
解码时需处理 '=' 填充、非法字符和长度校验。该版本会抛出 std::invalid_argument 异常(可按需改为返回空字符串):
#include#include std::string base64_decode(const std::string& input) { // 忽略空白符(如换行、空格),但不自动跳过非法字符 std::string clean; for (char c : input) if (!std::isspace(static_cast
(c))) clean += c; if (clean.empty()) return {}; size_t len = clean.length(); if (len % 4 != 0) throw std::invalid_argument("Base64 string length not multiple of 4"); // 检查结尾填充是否合法:最多两个 '=',且必须在末尾 size_t pad = 0; if (len >= 2 && clean[len-1] == '=') pad++; if (len >= 2 && clean[len-2] == '=') pad++; std::string output; output.reserve((len * 3) / 4 - pad); std::vectorlookup(256, -1); for (size_t i = 0; i < base64_chars.length(); ++i) lookup[static_cast (base64_chars[i])] = static_cast (i); for (size_t i = 0; i < len; i += 4) { int p0 = lookup[static_cast (clean[i])]; int p1 = lookup[static_cast (clean[i+1])]; int p2 = (i + 2 < len && clean[i+2] != '=') ? lookup[static_cast (clean[i+2])] : 0; int p3 = (i + 3 < len && clean[i+3] != '=') ? lookup[static_cast (clean[i+3])] : 0; if (p0 == -1 || p1 == -1 || (i+2 < len && clean[i+2] != '=' && p2 == -1) || (i+3 < len && clean[i+3] != '=' && p3 == -1)) throw std::invalid_argument("Invalid Base64 character"); unsigned char b0 = (p0 << 2) | (p1 >> 4); unsigned char b1 = ((p1 & 0x0f) << 4) | (p2 >> 2); unsigned char b2 = ((p2 & 0x03) << 6) | p3; output.push_back(b0); if (i + 2 < len && clean[i+2] != '=') output.push_back(b1); if (i + 3 < len && clean[i+3] != '=') output.push_back(b2); } return output; }
立即学习“C++免费学习笔记(深入)”;
完整使用示例(含中文、二进制测试)
验证编码/解码一致性,支持 UTF-8 字符串和任意二进制数据:
#include#include int main() { // 示例1:普通字符串 std::string s1 = "Hello, 世界"; std::string enc1 = base64_encode(s1); std::string dec1 = base64_decode(enc1); assert(dec1 == s1); std::cout << "Text: " << enc1 << "\n"; // SGVsbG8sIOS4lueVjA==
// 示例2:含空字节的二进制数据 std::string bin = "ABC\0XYZ"; std::string enc2 = base64_encode(bin); std::string dec2 = base64_decode(enc2); assert(dec2 == bin); std::cout zuojiankuohaophpcnzuojiankuohaophpcn "Binary len: " zuojiankuohaophpcnzuojiankuohaophpcn enc2 zuojiankuohaophpcnzuojiankuohaophpcn " (" zuojiankuohaophpcnzuojiankuohaophpcn dec2.length() zuojiankuohaophpcnzuojiankuohaophpcn " bytes)\n"; return 0;}
立即学习“C++免费学习笔记(深入)”;
基本上就这些。代码无第三方依赖,兼容 C++11 及以上,可直接复制使用。注意:生产环境若需更高性能或更严格式(如 URL 安全变体),可考虑 boost::beast::detail::base64 或 OpenSSL EVP,但对大多数场景,上述实现已足够清晰、可靠、易维护。










