Convert.ToBase64String和Convert.FromBase64String是C#中最直接、轻量的Base64编解码方法，适用于内存中byte[]数据，需注意UTF-8编码转换、非标准字符串清理、大文件流式处理及URL/JSON兼容性问题。
用 Convert.ToBase64String 和 Convert.FromBase64String 最直接
这两个静态方法是 C# 中最常用、最轻量的 Base64 编解码方式，适用于内存中已有的 byte[] 数据。不需要额外引用，System 命名空间自带。
- 编码：把字节数组转成 Base64 字符串，结果不含换行、无空格，纯 ASCII
- 解码：必须传入合法的 Base64 字符串，否则抛出
FormatException - 注意：输入字符串需是 UTF-8 编码的原始文本时，要先用
Encoding.UTF8.GetBytes()转成字节数组再编码
string original = "Hello 世界"; byte[] bytes = Encoding.UTF8.GetBytes(original); string encoded = Convert.ToBase64String(bytes); // "SGVsbG8g5L2g5aW9" <p>byte[] decodedBytes = Convert.FromBase64String(encoded); string decoded = Encoding.UTF8.GetString(decodedBytes); // "Hello 世界"
处理非标准 Base64 字符串（含换行、空格、URL 不友好字符）
HTTP 查询参数或文件内容里常出现带换行、空格或用 -/_ 替代 +// 的变体（即 Base64Url 编码），Convert.FromBase64String 会直接报错。
- 先清理：用
.Replace(" ", "").Replace("\r", "").Replace("\n", "")去掉空白 - Base64Url 场景：需手动替换
-→+、_→/，再补足等号（长度需是 4 的倍数） - 补等号逻辑：计算当前长度 % 4，缺几位就补几个
=；例如长度 31 → 补 1 个=
string urlSafe = "SGVsbG8g5L2g5aW9"; // 普通 Base64 // 若是 Base64Url："SGVsbG8g5L2g5aW9" → 实际可能写成 "SGVsbG8g5L2g5aW9" string padded = urlSafe.PadRight(urlSafe.Length + (4 - urlSafe.Length % 4) % 4, '='); byte[] result = Convert.FromBase64String(padded);
大文件或流式数据别一次性读进内存
对几 MB 以上的文件直接用 File.ReadAllBytes + Convert.ToBase64String 容易触发 GC 压力甚至 OutOfMemoryException。应改用流式处理。
- 编码大文件：用
StreamReader读原文本块，逐段转byte[]再编码，拼接字符串（注意不要用+=） - 更稳妥方案：用
System.Security.Cryptography.CryptoStream配合FromBase64Transform/ToBase64Transform，但它们已标记为 [Obsolete]，仅限 .NET Framework - .NET 5+ 推荐：用
System.IO.Stream+ 自定义缓冲区，或借助第三方库如Microsoft.Toolkit.HighPerformance的Base64.EncodeToUtf8
编码后字符串长度和 URL/JSON 兼容性问题
Base64 编码会使体积膨胀约 33%（每 3 字节 → 4 字符），且默认含 +、/、=，在 URL 或 JSON 中需额外处理。
- URL 场景：必须做 Base64Url 编码（
+→-，/→_，去掉末尾=） - JSON 场景：虽然
+//合法，但某些旧解析器会误判；建议统一用 Base64Url 变体 - 长度校验：解码前可快速检查字符串长度是否为 4 的倍数，以及是否只含 Base64 字符集（A–Z a–z 0–9 + / =），避免异常爆炸
真正容易被忽略的是：不同平台对 Base64 填充等号的容忍度不一，有些库允许省略，有些强制要求。生产环境建议始终补全并验证格式，而不是依赖“看起来差不多”。
