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 字符加 \r\n），得手动分段处理
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 这两个函数，它们只是工具，不是解决方案。 
