必须先将图像转为字节数组再调用Convert.ToBase64String，正确路径是：图片→流→字节数组→Base64字符串；需指定图像格式，注意跨平台兼容性、data URL前缀需求及大图内存隐患。
用 Convert.ToBase64String 之前必须先读成字节数组
直接对 Image 或 Bitmap 对象调用 Convert.ToBase64String 会编译失败——它只接受 byte[]。常见错误是试图传入 image.ToString() 或直接传对象，结果得到无意义的字符串（比如 "System.Drawing.Bitmap"）。
正确路径是：图片 → 流 → 字节数组 → Base64 字符串。关键在于选择合适的图像格式和编码方式：
- 用
MemoryStream中转，避免临时文件 IO - 务必指定图像格式（如
Png、Jpeg），否则Save()可能抛出ArgumentException（尤其对 PNG 图像调用ImageFormat.Jpeg） - 如果原图是 PNG 且含透明通道，改用
Jpeg会丢失 Alpha 通道，且无法还原
using (var ms = new MemoryStream())
{
image.Save(ms, ImageFormat.Png); // 注意这里必须指定格式
byte[] bytes = ms.ToArray();
string base64 = Convert.ToBase64String(bytes);
}
处理 System.Drawing.Common 在 .NET Core/.NET 5+ 中的兼容性问题
在 .NET Core 3.0+ 或 .NET 5/6/7/8 项目中，System.Drawing 不再跨平台默认可用。Linux/macOS 上直接 new Bitmap 会抛 PlatformNotSupportedException。
解决方法不是“加引用就完事”，而是明确以下两点：
- 若项目目标框架是
net6.0-windows或更高，可安装System.Drawing.Common包，并确认运行时为 Windows - 若需真正跨平台（如部署到 Linux 容器），应改用
ImageSharp（推荐）或SkiaSharp，它们不依赖 GDI+ -
System.Drawing.Common在非 Windows 平台需额外安装系统级依赖（如 libgdiplus），CI/CD 构建容易失败
用 ImageSharp 的等效写法更简洁且安全：
using (var image = Image.Load(filePath))
using (var ms = new MemoryStream())
{
image.Save(ms, new PngEncoder()); // 或 JpegEncoder()
string base64 = Convert.ToBase64String(ms.ToArray());
}
Base64 字符串前缀（data URL）要不要加？看使用场景
纯 Base64 字符串（如 "iVBORw0KGgo..."）和带 data URL 前缀的（如 "data:image/png;base64,iVBORw0KGgo..."）本质不同：前者是原始编码数据，后者是完整可嵌入 HTML/CSS 的 URI。
是否添加前缀取决于下游怎么用：
- 前端
- 后端 API 接收 Base64 图片字段（如 JSON 中的
"avatar": "iVBOR..."），通常约定不带前缀，避免服务端解析逻辑耦合 MIME 类型 - 如果图片格式不确定，又必须返回 data URL，建议从流中探测真实类型（如用
Image.DetectFormat或ImageSharp.Image.Identify），而不是依赖文件扩展名
大图转 Base64 的内存与性能隐患
Base64 编码会使体积膨胀约 33%，一张 5MB 的 JPG 转完变成约 6.7MB 字符串。更危险的是中间过程：加载高清图 → 解码为位图 → 再编码为字节 → 转 Base64，可能触发 GC 压力甚至 OutOfMemoryException。
实际部署中要注意：
- 限制输入图片尺寸（如预缩放至最大 2000px 宽）和体积（如
FileInfo.Length > 10 * 1024 * 1024就拒绝） - 避免在 ASP.NET Core 同步 Action 中处理大图；考虑用
Stream直接读取并分块编码（虽 Base64 本身不支持流式编码，但可用Convert.ToBase64String(byte[], int, int)分段） - 如果只是临时预览，优先考虑返回 CDN URL 或 Blob URL，而非 Base64
真正需要 Base64 的场景其实很窄：内联小图标、邮件模板嵌入、离线 PWA 资源。别把它当通用图片传输方案。
