于建敏 發表於 2026-1-13 08:46:03

C#使用Spire.Barcode for .NET快速生成二维码

<div id="navCategory"><h5 class="catalogue">目录</h5><ul class="first_class_ul"><li>引言</li><li>环境准备</li><li>基础实现：生成简单二维码</li><ul class="second_class_ul"><li>代码解释</li></ul><li>进阶功能：自定义二维码样式 （嵌入图片）</li><ul class="second_class_ul"><li>关键参数说明</li></ul><li>常见问题与注意事项</li><ul class="second_class_ul"></ul></ul></div><p class="maodian"></p><h2>引言</h2>
<p>二维码作为一种高效的信息承载方式，广泛应用于支付、物流、身份验证等场景。在 .NET 开发中，借助 Spire.Barcode for .NET 提供了一个轻量级且功能完整的解决方案，支持生成和读取多种条形码与二维码格式。本文将详细介绍如何使用该库生成二维码。</p>
<p class="maodian"></p><h2>环境准备</h2>
<p>首先，通过NuGet安装必要的包：</p>
<div class="jb51code"><pre class="brush:bash;">Install-Package Spire.Barcode
</pre></div>
<p class="maodian"></p><h2>基础实现：生成简单二维码</h2>
<p>以下示例展示如何生成一个包含文本内容的基础二维码，并保存为本地图片：</p>
<div class="jb51code"><pre class="brush:csharp;">using Spire.Barcode;
using System.Drawing;
using System.Drawing.Imaging;

namespace GenerateQRCode
{
    class Program
    {
      static void Main(string[] args)
      {
            // 初始化条码设置
            BarcodeSettings settings = new BarcodeSettings();
            // 将条码类型设置为 QR Code 二维码
            settings.Type = BarCodeType.QRCode;
            // 设置二维码内容（可自定义：文本、URL、手机号等）
            settings.Data = "https://www.example.com/";
            // 设置数字编码模式
            settings.QRCodeDataMode = QRCodeDataMode.Auto;
         
            // 创建二维码生成器实例
            BarCodeGenerator generator = new BarCodeGenerator(settings);
            // 生成二维码图片
            Image qr = generator.GenerateImage();
            // 保存图片
            qr.Save("QR Code.png", ImageFormat.Png);
      }
    }
}
</pre></div>
<p class="maodian"></p><h3>代码解释</h3>
<ul><li><code>BarcodeSettings</code> 类: 初始化配置对象，所有条码的生成规则（类型、数据、样式）都通过该对象配置；</li><li><code>QRCodeDataMode</code>：数据编码模式。设为 <code>Auto</code> 时组件自动识别数据类型（如 URL、纯数字、中文），无需手动指定；</li><li><code>BarcodeGenerator</code> 类：核心生成器类，将配置传入生成器，建立「配置 - 生成」的关联；</li><li><code>GenerateImage</code> 方法: 基于配置生成二维码图片；</li><li><code>Save</code> 方法：将生成的二维码保存为图片，第一个参数为保存路径，第二个参数为图片格式。</li></ul>
<p class="maodian"></p><h2>进阶功能：自定义二维码样式 （嵌入图片）</h2>
<p>Spire.Barcode 支持在二维码中嵌入 logo 图片，并自定义二维码的显示文本、尺寸、纠错级别等，满足个性化需求。</p>
<div class="jb51code"><pre class="brush:csharp;">using Spire.Barcode;
using System;
using System.Drawing;
using System.Drawing.Imaging;

namespace GenerateQRCode
{
    class Program
    {
      static void Main(string[] args)
      {
            try
            {
                // 1. 初始化二维码配置对象（精细化配置核心）
                BarcodeSettings settings = new BarcodeSettings();

                // 2. 基础类型与内容配置
                settings.Type = BarCodeType.QRCode; // 指定生成二维码
                settings.Data = "https://www.example.com/"; // 二维码核心数据
                settings.Data2D = "Scan to go to example.com"; // 二维码底部显示的文本）
                settings.ShowTextOnBottom = true; // 显示底部文本
                settings.TextFont = new Font(FontFamily.GenericSansSerif, 16.0f); // 底部文本字体与字号

                // 3. 二维码编码与容错配置
                settings.QRCodeDataMode = QRCodeDataMode.Auto; // 自动识别数据类型（文本/URL/数字等）
                settings.QRCodeECL = QRCodeECL.H; // 纠错级别H（最高，30%破损可恢复）

                // 4. 自定义码元尺寸（单个二维码小方块的宽度）
                settings.X = 3.0f;

                // 5. 嵌入Logo（建议Logo尺寸不超过二维码的15%-20%，避免影响识别）
                if (System.IO.File.Exists("Logo.png"))
                {
                  settings.QRCodeLogoImage = Image.FromFile("Logo.png");
                }
                else
                {
                  Console.WriteLine("未找到Logo.png，将生成无Logo的二维码");
                }

                // 6. 生成二维码并保存
                BarCodeGenerator generator = new BarCodeGenerator(settings);
                Image qrImage = generator.GenerateImage(); // 生成二维码图片对象
                qrImage.Save("CustomizeCode.png", ImageFormat.Png); // 保存为PNG格式（无压缩，识别率高）

                Console.WriteLine("二维码生成成功！文件路径：" + AppDomain.CurrentDomain.BaseDirectory + "QR Code.png");
            }
            catch (Exception ex)
            {
                Console.WriteLine("二维码生成失败：" + ex.Message);
            }

            Console.ReadLine();
      }
    }
}
</pre></div>
<p class="maodian"></p><h3>关键参数说明</h3>
<p><code>QRCodeLogoImage</code>：嵌入 Logo 图。需确保图片文件路径正确，Logo 尺寸过大会导致二维码无法识别（建议占比&le;20%）；</p>
<p><code>QRCodeECL</code>：QRCode 的纠错级别，可选值：</p>
<ul><li><strong>L</strong>：7% 的破损可恢复；</li><li><strong>M</strong>：15% 的破损可恢复（默认）；</li><li><strong>Q</strong>：25% 的破损可恢复；</li><li><strong>H</strong>：30% 的破损可恢复。</li></ul>
<p class="maodian"></p><h2>常见问题与注意事项</h2>
<ol><li><strong>Logo 图片路径问题</strong>：若提示 &ldquo;文件不存在&rdquo;，需检查 <code>Logo.png</code> 的路径，或使用绝对路径（如 <code>C:/Images/Logo.png</code>）；</li><li><strong>文本显示异常</strong>：若底部文本乱码或不显示，需确保字体存在，建议使用系统内置字体（如Arial、SimSun）；</li><li><strong>内容长度限制</strong>：二维码的内容长度与纠错级别相关，纠错级别越高，可承载的字符数越少（如 <code>H</code> 级别最多可承载约128个汉字）；</li><li><strong>图片格式</strong>：推荐使用 <code>PNG</code> 格式保存二维码，相比 <code>JPG</code> 无压缩失真，扫描识别率更高；</li><li><strong>二维码识别失败</strong>：若嵌入 Logo 后无法识别，需缩小 Logo 尺寸（建议&le;二维码的 15%），或降低纠错级别（如改为 Q/M）。</li></ol>
<p>通过本文介绍的方法，开发者可以通过简单 API 快速实现二维码生成功能，并自定义显示文本、纠错级别、嵌入logo等关键参数。在实际项目中，建议根据具体需求对二维码的尺寸、颜色和内容进行优化，以确保最佳的扫描体验和用户体验。</p>
<p>以上就是C#使用Spire.Barcode for .NET快速生成二维码的详细内容，更多关于C# Spire.Barcode for .NET生成二维码的资料请关注琼殿技术社区其它相关文章！</p>
                           
                            <div class="art_xg">
                              <b>您可能感兴趣的文章:</b><ul><li>基于C#实现二维码和条形码生成与打印</li><li>在ASP.NET项目中如何使用C#生成二维码</li><li>C#使用ThoughtWorks.QRCode生成二维码</li><li>C#使用QRCode生成海报图并嵌入定位带logo的二维码</li></ul>
                            </div>

                        </div>
                        <!--endmain-->
頁: [1]
查看完整版本: C#使用Spire.Barcode for .NET快速生成二维码