C#实战：5分钟搞定带Logo的二维码生成（附完整源码）-开发者社区

C#实战：5分钟搞定带Logo的二维码生成（附完整源码）

在数字化营销和移动支付普及的今天，二维码已成为连接线上线下场景的重要媒介。对于企业而言，在二维码中嵌入品牌Logo不仅能提升专业形象，还能增强用户信任度。本文将带你用C#快速实现这一需求，从环境配置到完整代码实现，5分钟即可集成到现有项目中。

1. 环境准备与核心库选择

开发带Logo的二维码功能，我们首选ZXing.Net库。这个开源库不仅支持多种条码格式，还能灵活处理二维码的自定义样式。通过NuGet包管理器安装只需两步：

Install-Package ZXing.Net -Version 0.16.8 Install-Package ZXing.Net.Bindings.Windows.Compatibility -Version 0.16.8

提示：第二个包提供了对System.Drawing的兼容支持，特别是在.NET Core/5+环境中必不可少。

常见问题排查表：

问题现象	解决方案
无法加载System.Drawing	确保安装兼容性绑定包
生成的二维码模糊	检查输出尺寸是否过小
Logo显示位置偏移	调整居中计算算法

2. 基础二维码生成实现

我们先构建一个基础二维码生成器类，后续再扩展Logo功能。创建QrCodeGenerator.cs文件：

using ZXing; using ZXing.QrCode; using System.Drawing; public class QrCodeGenerator { public Bitmap GenerateBaseQr(string content, int size = 300) { var options = new QrCodeEncodingOptions { DisableECI = true, CharacterSet = "UTF-8", Width = size, Height = size, Margin = 1 }; var writer = new BarcodeWriterPixelData { Format = BarcodeFormat.QR_CODE, Options = options }; var pixelData = writer.Write(content); var bitmap = new Bitmap(pixelData.Width, pixelData.Height); using (var bitmapData = bitmap.LockBits(...)) { // 像素数据填充... } return bitmap; } }

关键参数说明：

CharacterSet：必须设为UTF-8以支持中文
Margin：控制二维码边距，建议1-2像素
ErrorCorrection：默认L级别，可提升至H增强容错

3. Logo嵌入的进阶实现

带Logo的二维码需要特别注意三个技术点：

Logo尺寸不能超过二维码容错区域
需要精确计算居中位置
背景需要白色填充保证可读性

改进后的生成方法：

public Bitmap GenerateQrWithLogo(string content, Image logo, int size = 300) { // 生成基础二维码 var qrBitmap = GenerateBaseQr(content, size); // 计算Logo合适尺寸（不超过二维码25%） int logoMaxSize = (int)(size * 0.25); int logoWidth = Math.Min(logo.Width, logoMaxSize); int logoHeight = Math.Min(logo.Height, logoMaxSize); // 创建合成画布 var combined = new Bitmap(size, size); using (var g = Graphics.FromImage(combined)) { g.DrawImage(qrBitmap, 0, 0); // 绘制白色背景框 int posX = (size - logoWidth) / 2; int posY = (size - logoHeight) / 2; g.FillRectangle(Brushes.White, posX, posY, logoWidth, logoHeight); // 叠加Logo g.DrawImage(logo, posX, posY, logoWidth, logoHeight); } return combined; }

实际项目中建议添加的参数校验：

内容非空检查
Logo尺寸阈值验证
输出尺寸范围限制

4. 实战应用与性能优化

在企业级应用中，我们还需要考虑：

批量生成方案

public void BatchGenerate(IEnumerable<QrRequest> requests) { Parallel.ForEach(requests, req => { using var logo = Image.FromFile(req.LogoPath); var qr = GenerateQrWithLogo(req.Content, logo); qr.Save(Path.Combine(req.OutputDir, $"{req.Id}.png")); }); }

内存优化技巧

使用using语句确保资源释放
考虑对象池复用Bitmap实例
异步生成避免UI阻塞

典型应用场景对比

场景	推荐配置	注意事项
印刷物料	600px+尺寸	使用矢量Logo
APP内嵌	200-300px	透明背景PNG
支付二维码	固定尺寸	严格测试扫码识别率

5. 完整解决方案示例

以下是可直接集成到ASP.NET Core项目的服务类：

public interface IQrService { byte[] GenerateQrBytes(string content, Stream logoStream = null); Stream GenerateQrStream(string content, Stream logoStream = null); } public class ZXingQrService : IQrService { public byte[] GenerateQrBytes(string content, Stream logoStream = null) { using var ms = new MemoryStream(); using var bitmap = logoStream != null ? GenerateWithLogo(content, logoStream) : GenerateBaseQr(content); bitmap.Save(ms, ImageFormat.Png); return ms.ToArray(); } private Bitmap GenerateWithLogo(string content, Stream logoStream) { using var logo = Image.FromStream(logoStream); return GenerateQrWithLogo(content, logo); } }

在Startup中注册服务：

services.AddSingleton<IQrService, ZXingQrService>();

控制器调用示例：

[HttpGet("qr")] public IActionResult GetQr([FromQuery]string text, [FromQuery]string logoUrl) { using var http = new HttpClient(); var logoStream = !string.IsNullOrEmpty(logoUrl) ? http.GetStreamAsync(logoUrl).Result : null; var bytes = _qrService.GenerateQrBytes(text, logoStream); return File(bytes, "image/png"); }