C#批量生成带Logo的二维码？我写了个小工具解放双手（Free Spire.Barcode实战）
C#实战：批量生成带Logo的二维码自动化工具开发指南
每次需要为上百名员工生成工牌二维码时，手动操作不仅耗时还容易出错。作为技术负责人，我花了三个周末终于开发出一套稳定高效的解决方案。这套基于Free Spire.Barcode的自动化工具，现在只需点击一次就能完成过去需要整天的工作量。
1. 工具设计与核心功能规划
在开始编码前，我们需要明确工具的核心需求和架构设计。这个批量二维码生成器主要解决以下痛点：
- 数据源处理：支持从Excel/CSV读取批量数据
- Logo统一嵌入：保持品牌视觉一致性
- 自动化命名：根据数据字段智能生成文件名
- 错误处理：确保单条记录失败不影响整体流程
工具工作流程如下：
graph TD A[读取数据源] --> B[遍历每条记录] B --> C{是否有效数据?} C -->|是| D[生成带Logo二维码] C -->|否| E[记录错误日志] D --> F[按规则保存文件] E --> G[生成错误报告] F --> H[完成批量处理]2. 环境配置与基础搭建
2.1 项目初始化
首先创建.NET Core控制台应用，并通过NuGet安装必要依赖：
dotnet new console -n QRBatchGenerator cd QRBatchGenerator dotnet add package FreeSpire.Barcode dotnet add package EPPlus # 用于Excel处理2.2 基础配置类设计
创建QrConfig.cs定义可配置参数：
public class QrConfig { public int ModuleSize { get; set; } = 4; public QRCodeECL ErrorCorrection { get; set; } = QRCodeECL.H; public string LogoPath { get; set; } public Color Foreground { get; set; } = Color.Black; public Color Background { get; set; } = Color.White; public bool AddBorder { get; set; } = true; public string OutputDir { get; set; } = "Output"; }3. 核心生成逻辑实现
3.1 单二维码生成方法
public static Bitmap GenerateSingleQR(string content, QrConfig config) { var settings = new BarcodeSettings { Type = BarCodeType.QRCode, Data = content, Data2D = content, QRCodeECL = config.ErrorCorrection, X = config.ModuleSize, QRCodeLogoImage = !string.IsNullOrEmpty(config.LogoPath) ? Image.FromFile(config.LogoPath) : null, BackColor = config.Background, ForeColor = config.Foreground, HasBorder = config.AddBorder, BorderWidth = 1 }; return new BarCodeGenerator(settings).GenerateImage(); }3.2 批量处理引擎
public class BatchProcessor { public void Process(DataTable data, QrConfig config) { // 确保输出目录存在 Directory.CreateDirectory(config.OutputDir); var errors = new List<string>(); int successCount = 0; foreach (DataRow row in data.Rows) { try { var url = row["URL"].ToString(); var fileName = $"{row["EmployeeID"]}_{row["Name"]}.png"; var qrImage = GenerateSingleQR(url, config); qrImage.Save(Path.Combine(config.OutputDir, fileName)); successCount++; } catch (Exception ex) { errors.Add($"行 {data.Rows.IndexOf(row)}: {ex.Message}"); } } // 生成处理报告 GenerateReport(successCount, errors); } }4. 高级功能扩展
4.1 动态Logo替换
某些场景需要根据不同部门使用不同Logo：
public Image GetDepartmentLogo(string deptCode) { var logoPath = deptCode switch { "HR" => "Assets/HR_Logo.png", "IT" => "Assets/IT_Logo.png", _ => "Assets/Default_Logo.png" }; return Image.FromFile(logoPath); }4.2 二维码质量检测
添加简单的可读性验证：
public bool ValidateQR(Bitmap qrImage) { try { var results = BarcodeScanner.Scan(qrImage); return results.Any(); } catch { return false; } }5. 实战应用示例
5.1 员工工牌生成系统
完整调用示例：
static void Main(string[] args) { // 加载配置 var config = new QrConfig { LogoPath = "CompanyLogo.png", OutputDir = "EmployeeBadges" }; // 读取Excel数据 using var package = new ExcelPackage(new FileInfo("Employees.xlsx")); var data = package.Workbook.Worksheets[0].ToDataTable(); // 批量生成 new BatchProcessor().Process(data, config); Console.WriteLine("工牌二维码批量生成完成！"); }5.2 会议签到系统二维码
针对大型会议的场景优化：
var eventConfig = new QrConfig { ModuleSize = 6, // 更大的模块尺寸 ErrorCorrection = QRCodeECL.Q, AddBorder = false, Foreground = Color.DarkBlue, OutputDir = $"Event_{DateTime.Now:yyyyMMdd}" };6. 性能优化技巧
处理上万条记录时，这些优化很关键：
- 内存管理：及时释放图像资源
- 并行处理：利用多核CPU优势
- 进度反馈：显示处理进度
优化后的并行处理代码：
Parallel.ForEach(data.AsEnumerable(), row => { var qrImage = GenerateSingleQR(row["URL"].ToString(), config); qrImage.Save(Path.Combine(config.OutputDir, $"{row["ID"]}.png")); qrImage.Dispose(); });7. 异常处理与日志记录
健壮的错误处理机制必不可少：
public class ErrorLogger { public static void Log(Exception ex, string context) { string logContent = $"[{DateTime.Now}] {context}\n{ex}\n\n"; File.AppendAllText("error_log.txt", logContent); } }在项目中使用Serilog等专业日志库可以获得更强大的日志功能。
8. 工具打包与部署
最后将工具打包为可执行文件：
- 发布独立应用：
dotnet publish -c Release -r win-x64 --self-contained true- 创建批处理脚本方便非技术人员使用：
@echo off QRBatchGenerator.exe config.json pause实际部署时，可以将工具配置为Windows计划任务或Linux cron作业，实现定时自动生成。