C# Base64与文件互转 C#如何实现文件和Base64字符串的转换

base64转换核心是file.readallbytes读二进制+convert.tobase64string编码，大文件需流式分块处理，解码后须用file.writeallbytes原样写入，且需注意路径转义、非法字符、mime类型缺失等边界问题。

File.ReadAllBytes 读取文件后用 Convert.ToBase64String 编码

直接把文件转成 Base64 字符串，核心是两步：读二进制、编码。不要用 StreamReader 或文本方式读，否则会损坏非文本文件（如图片、PDF）。必须用 File.ReadAllBytes 获取原始字节流，再交给 Convert.ToBase64String：

string base64 = Convert.ToBase64String(File.ReadAllBytes(@"C:test.jpg"));

• 路径中反斜杠要双写或用 @ 前缀，否则 t 会被解析为制表符
• 大文件慎用 File.ReadAllBytes，它会一次性加载全部内容到内存；超过 100MB 建议改用 FileStream 分块读 + Convert.ToBase64Transform
• Base64 字符串不含换行符，.NET 默认输出不带换行；若需 RFC 2045 兼容格式（每 76 字符加 rn），得手动分段处理

Convert.FromBase64String 解码后用 File.WriteAllBytes 写入文件

反向操作更简单，但关键在解码后的字节必须原样写回磁盘——不能经过任何文本编码（如 UTF-8）中转：

byte[] bytes = Convert.FromBase64String(base64);<br>File.WriteAllBytes(@"C:output.pdf", bytes);

• Convert.FromBase64String 对非法字符（如空格、换行、非 Base64 字符）直接抛 FormatException，务必用 try/catch 包裹
• 如果 Base64 字符串来自网页表单或 URL 参数，可能含 +、/、= 之外的字符（比如 URL 安全变体用 - 和 _），需先替换再解码
• File.WriteAllBytes 会覆盖目标文件，若需避免误删，先用 File.Exists 检查

Stream 方式处理大文件避免内存溢出

读写超大文件（如视频、数据库备份）时，ReadAllBytes 很容易触发 OutOfMemoryException。正确做法是全程用 Stream 流式处理：

using var input = File.OpenRead(@"C:big.zip");<br>using var output = File.Create(@"C:big.b64");<br>using var base64Writer = new StreamWriter(output);<br>using var base64Stream = new ToBase64Transform();<br>// 实际需配合 CryptoStream 或自定义缓冲写入逻辑，.NET 无内置流式 Base64 编码器<br>// 更推荐：分块读取 input，每 3 字节调用 Convert.ToBase64String(3-byte-array)，拼接输出

• .NET 没有开箱即用的流式 Base64 编/解码器；ToBase64Transform 是加密类，需搭配 CryptoStream 使用，且仅支持固定块大小
• 实用方案：每次读取 3072 字节（3 的倍数），传给 Convert.ToBase64String，结果追加到 StreamWriter，避免单次分配大数组
• 解码大 Base64 时同理：按 4 字符一组解析，每 4 字符转 3 字节，写入 FileStream

Base64 转文件时注意扩展名和 MIME 类型丢失

Base64 字符串本身不携带文件名或类型信息。从 Base64 还原文件时，必须额外保存或约定扩展名，否则无法正确打开：

• 常见做法是在 Base64 前加 data URI 头，如 data:image/png;base64,iVBORw0...，解析时用正则提取 image/png 并映射为 .png
• 更可靠的是业务层显式传递文件名或类型字段，而不是靠魔数（file signature）自动识别——后者对 ZIP、EXE 等通用格式有效，但对 json、xml 等纯文本格式不可靠
• 若 Base64 来自前端 FileReader.readAsDataURL，其返回值已含 MIME，可直接截取使用

实际转换逻辑本身很薄，真正容易出问题的是边界场景：非法输入、内存压力、元数据缺失。别只盯着 Convert.ToBase64String 和 Convert.FromBase64String 这两个函数，它们只是工具，不是解决方案。