C#如何生成二维码中间带Logo_C# QRCoder高级自定义样式【极简】

# QRCoder 加 Logo 的真相：不是“能不能”，而是“怎么加才扫得出” > 直接说结论：QRCoder 本身不提供 Logo 叠加功能，但可以通过 `Bitmap` 手动合成。真正的关键不是“怎么把图贴上去”，而是“贴在哪里、留多大空间、如何抗锯齿”——否则 Logo 会压坏定位图案，导致二维码彻底失效。 ## 为什么 QRCoder 生成的 Bitmap 不能直接画 Logo？ 默认生成的二维码是纯黑白像素矩阵，没有为中间区域预留任何“安全区”。如果直接把 Logo 图片覆盖上去，极大概率会压住三个角上的核心定位图案（Finder Pattern）或时序图案（Timing Pattern），导致大多数扫码器无法识别。 QRCoder 的 `QRCodeData` 对象并不暴露内部模块的坐标映射，因此无法实现“智能避开关键区域”的绘制。 * **错误做法**：`qrCodeImage.DrawImage(logo, x, y)` 硬性贴图。手动估算的 x/y 坐标稍有偏差，Logo 就会覆盖关键模块，导致扫码失败。 * **正确思路**：先计算出二维码中心的安全区域尺寸 → 将 Logo 缩放至该尺寸 → 居中绘制 → 对 Logo 边缘进行简单的抗锯齿处理（例如使用 `InterpolationMode.HighQualityBicubic`）。 * **安全区域经验公式**：`int safeSize = (int)(qrCodeImage.Width * 0.25);`（即取二维码宽度的 25%，这个尺寸通常不会侵入定位图案的内边距）。 ## 如何用 QRCoder + GDI+ 实现稳定可扫的带 Logo 二维码？ 必须使用 `QRCodeGenerator.ECCLevel.Q`（约 25% 容错）或更高级别的 `H`（约 30% 容错），为 Logo 覆盖预留足够的纠错冗余。生成基础二维码后，不应直接在其原始 `Bitmap` 上操作，而应创建一个新的画布进行合成。 1. **生成二维码数据**：调用 `qrGenerator.CreateQrCode(data, QRCodeGenerator.ECCLevel.Q)` 创建高容错数据。 2. **获取基础图像**：使用 `new QRCode(qrCodeData).GetGraphic(20)` 获取基础二维码图（参数 `20` 是像素模块的缩放因子，不建议用 `1`，否则图像太小）。 3. **创建合成画布**：创建一个与二维码同尺寸的新 `Bitmap`，并用 `Graphics.FromImage()` 获取其画布。务必开启 `SmoothingMode.AntiAlias` 和 `InterpolationMode.HighQualityBicubic` 以保证绘制质量。 4. **分层绘制**：先在新画布上 `DrawImage` 绘制二维码基础图，然后计算中心安全区域矩形 `new Rectangle(centerX - safeSize/2, centerY - safeSize/2, safeSize, safeSize)`，最后在此矩形内居中绘制缩放后的 Logo。 ## Logo 图片预处理的三个硬性要求 并非任何 PNG 图片都适合用作 Logo。扫码失败的案例中，约有 70% 问题出在 Logo 图片本身。 * **必须为正方形**：非等比缩放会导致 Logo 变形，可能意外压到二维码的模块线。建议在绘制前用代码进行裁切：`logo = CropToSquare(logo)`。 * **背景必须透明**：Logo 必须具有有效的 Alpha 通道。使用纯白色背景的 PNG，会覆盖掉二维码的白色模块，形成“伪黑块”，严重干扰解码。 * **避免复杂边缘**：Logo 边缘应避免使用过细的线条或高对比度的文字。Logo 自身视觉复杂度越高，越容易触及二维码纠错能力的边界。实测表明，当 Logo 宽度超过 80px 且设计复杂时，扫码失败率会显著上升。 最容易被忽略的一点是：`Graphics.DrawImage` 方法默认使用 `CompositingMode.SourceOver` 混合模式。如果 Logo 图片包含半透明的灰度像素，这些像素会与底层二维码的黑白模块混合，产生意外的中间色值，可能被某些扫码器误判。稳妥的做法是，在绘制前将 Logo 转换为 1-bit Alpha 格式（即只保留完全透明和完全不透明两种状态，其余区域填充为纯白）。