ZXing.Net 是 C# 中最稳定、兼容性最好的二维码生成方案，支持 .NET Core/.NET 5+ 及 .NET Framework 4.6.1+，需通过 NuGet 安装官方版本并配置 BarcodeWriter 的 QrCodeEncodingOptions（含 UTF-8 编码、尺寸、边距、容错等级等），注意中文处理、长文本限制、PNG 导出及内存释放，生成后须多端实测验证。
直接用 ZXing.Net 生成二维码图片是目前 C# 里最稳定、兼容性最好的方式，不需要依赖系统组件或外部服务，生成结果可控、可定制性强。
安装 ZXing.Net NuGet 包
别手动下载 DLL 或引用旧版源码——新版 ZXing.Net 已完全支持 .NET Core / .NET 5+，且修复了大量编码和图像尺寸问题。
- 在 Visual Studio 的“包管理器控制台”中运行：
Install-Package ZXing.Net - 确认安装的是
ZXing.Net（作者为micjahn），不是已停止维护的zxing（无 .NetStandard 支持） - 若项目是 .NET Framework 4.6.1+，同样适用；但 .NET Framework 4.0 及更早版本需降级到
ZXing.Net 0.16.5
用 BarcodeWriter 生成带样式的二维码图片
BarcodeWriter 是最常用入口，它默认输出 Bitmap，适合 WinForms/WPF/控制台快速出图。关键点在于配置 Options：
-
Format必须设为BarcodeFormat.QR_CODE，否则会静默失败（不报错但返回 null） -
Options.Width和Options.Height控制最终图片尺寸，不是“模块大小”；若只设一个，另一个按比例推算，但建议两个都显式指定，避免因缩放导致边缘模糊 - 设置
Options.Margin（单位：模块数），默认是 4，太小会导致扫码设备识别失败；一般保持 4–10 之间较稳妥 - 颜色通过
Options.PureBarcode = false（默认） + 自定义WriteableBitmap或用Bitmap后处理实现，原生不支持直接设前景/背景色
示例（生成 300×300 像素、带边距的二维码）：
var writer = new BarcodeWriter
{
Format = BarcodeFormat.QR_CODE,
Options = new QrCodeEncodingOptions
{
Width = 300,
Height = 300,
Margin = 6,
ErrorCorrection = ErrorCorrectionLevel.H // 推荐 H 级，容错更强
}
};
var bitmap = writer.Write("https://example.com");
// 保存：bitmap.Save("qrcode.png", ImageFormat.Png);
处理中文、特殊字符和长文本
ZXing 默认使用 ISO-8859-1 编码，直接传中文会乱码或生成失败。必须显式指定 UTF-8：
- 不要依赖自动检测——
QrCodeEncodingOptions.CharacterSet = "UTF-8"这一行不能省 - 长文本（>2953 字节）可能触发容量限制，此时
Write()会抛WriterException：“Data too big”；需提前截断或启用分段逻辑（ZXing 不自动分包） - 含换行符、制表符等不可见字符时，建议先
text.Trim()再编码，否则可能生成无效二维码 - 若内容含 URL，确保已做 URL 编码（如空格 → %20），否则某些扫码器无法跳转
导出为 PNG/JPG 并避免 GDI+ 内存泄漏
用 Bitmap.Save() 导出常见于示例，但在高频调用（如 Web API）场景下容易引发 OutOfMemoryException —— 因为 Bitmap 持有非托管资源，未及时释放。
- 务必用
using包裹：using (var bitmap = writer.Write(...)) { bitmap.Save(...); } - Web 场景推荐转为
byte[]直接写入响应流，避免临时文件或内存堆积 - JPEG 格式不推荐用于二维码：有损压缩可能导致模块边界模糊，扫码成功率下降；坚持用 PNG
- 如需抗锯齿或自定义 DPI（如打印用途），得自行用
Graphics绘制到高分辨率Bitmap，BarcodeWriter不提供该能力
真正麻烦的不是生成，而是验证——生成后务必用至少三款主流扫码 App（微信、支付宝、系统相机）实测，尤其注意低对比度、小尺寸、含 logo 的复合二维码是否仍可扫。ZXing 能画出来，不代表所有设备都能识读。
