c# 如何生成二维码-C#.Net教程-PHP中文网

ZXing.NET 是 C# 中最稳定、兼容性好、文档全的二维码生成方案，支持 .NET Framework 4.5+ 及 .NET Core 3.1+ 以上全平台，推荐通过 NuGet 安装并配置 BarcodeWriter 与 QrCodeEncodingOptions（含 UTF-8、高容错、合理尺寸与边距），注意空输入校验、资源释放、UI 线程安全及文件保存健壮性。

c# 如何生成二维码

ZXing.NET 是目前 C# 中最稳定、兼容性最好、文档最全的二维码生成方案，推荐直接用它，别折腾老库（如 ThoughtWorks.QRCode）或已停更的封装。它支持 .NET Framework 4.5+、.NET Core 3.1+ 和 .NET 5/6/7/8，WinForms、WPF、ASP.NET Core 全能跑。

安装 ZXing.NET 并初始化写入器

不手动下载 DLL，也不拖引用——用 NuGet 命令一行搞定：

dotnet add package ZXing.Net

或在 Visual Studio 包管理器控制台运行：

Install-Package ZXing.Net

然后在代码中引入命名空间：

using ZXing;
using ZXing.Common;
using ZXing.QrCode;

关键点：

BarcodeWriter 是生成入口，必须指定 Format = BarcodeFormat.QR_CODE
必须显式配置 QrCodeEncodingOptions，否则中文乱码、尺寸失控、容错低
别漏掉 options.CharacterSet = "UTF-8"，否则 TextBox 输入中文会变问号或报错

生成带中文内容的二维码（含防空校验）

常见错误：用户没输内容就点“生成”，writer.Write("") 直接抛 ArgumentNullException。

正确做法是加一层判断，并设置默认占位符：

private Bitmap GenerateQrCode(string content)
{
    if (string.IsNullOrWhiteSpace(content))
        content = "QR_EMPTY";
<pre class="brush:php;toolbar:false;">var writer = new BarcodeWriter
{
    Format = BarcodeFormat.QR_CODE,
    Options = new QrCodeEncodingOptions
    {
        DisableECI = true,
        CharacterSet = "UTF-8",
        Width = 300,
        Height = 300,
        Margin = 2,
        ErrorCorrection = ErrorCorrectionLevel.H // 高容错，推荐 M 或 H
    }
};
return writer.Write(content);

}

说明：

ErrorCorrectionLevel.H 比默认的 M 更抗划伤/污损，适合打印场景
Margin = 2 表示白边宽度（单位：模块数），太小（如 0）会导致扫码器无法识别
尺寸 Width/Height 建议设为 200~400，再小易糊，再大无意义（手机摄像头解析力有限）

保存为 PNG 文件并防止文件冲突

直接 bitmap.Save("xxx.png") 很危险：并发请求、重复点击、路径不存在都会崩。

GateCrash Forms

以 CLI 为先的表单构建器，采用 BYOK 理念。通过JSON Schema 生成美观的 HTML 表单，使用您自己的 SMTP 服务器处理提交，存储响应...

下载

安全写法要包含三件事：目录创建 + 唯一文件名 + 异常后释放资源：

public string SaveQrCode(Bitmap bitmap, string folderPath, string fileName = null)
{
    var dir = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, folderPath);
    Directory.CreateDirectory(dir);
<pre class="brush:php;toolbar:false;">fileName ??= $"qrcode_{DateTime.Now:yyyyMMddHHmmssfff}.png";
var fullPath = Path.Combine(dir, fileName);

try
{
    bitmap.Save(fullPath, ImageFormat.Png);
    return fullPath;
}
catch (Exception ex)
{
    throw new InvalidOperationException($"保存二维码失败: {ex.Message}", ex);
}
finally
{
    bitmap?.Dispose(); // 必须释放，否则内存泄漏
}

}

注意：

不要用 AppDomain.CurrentDomain.BaseDirectory 在 ASP.NET Core 中——改用 IWebHostEnvironment.WebRootPath
文件名里加毫秒级时间戳（fff）可基本避免重名，无需 GUID
WinForms 中若直接赋给 PictureBox.Image，记得先 Dispose() 旧图，否则 GDI 句柄耗尽

WinForms 点击按钮生成并显示到 PictureBox

这是最典型场景，但新手常卡在两处：图片不显示、界面卡死（因没走 UI 线程）。

完整事件处理逻辑如下：

private void btnGenerate_Click(object sender, EventArgs e)
{
    var text = textBoxInput.Text.Trim();
    if (string.IsNullOrEmpty(text))
    {
        MessageBox.Show("请输入内容", "提示", MessageBoxButtons.OK, MessageBoxIcon.Information);
        return;
    }
<pre class="brush:php;toolbar:false;">try
{
    var qrBitmap = GenerateQrCode(text);
    // WinForms 必须在 UI 线程设置 Image
    pictureBox1.Invoke((MethodInvoker)delegate
    {
        pictureBox1.Image?.Dispose();
        pictureBox1.Image = qrBitmap;
    });
}
catch (Exception ex)
{
    MessageBox.Show($"生成失败：{ex.Message}");
}

}

关键提醒：