简介这份资源是面向C#与WPF开发者的二维码生成与识别示例项目适合希望快速在桌面端集成扫码功能的初中级开发者。项目以Zxing.Net为核心通过BarcodeWriter与QrCodeEncodingOptions完成二维码生成并演示将位图绑定到WPF的Image控件显示识别部分则结合多媒体处理库从摄像头或图片中读取二维码内容覆盖生成与识别两条完整链路。压缩包共148个文件约22.48MB以35个dll、31个pdb、29个xml等依赖与调试文件为主另有12个cs源码、2个xaml界面文件、2个exe可执行程序及sln、csproj等工程文件结构完整可直接编译运行。目前已有1002人学习下载。读者可据此掌握二维码编码参数设置、UI绑定与图像解码的整合思路并参考工程组织方式快速搭建自己的扫码应用。1. 二维码在 WPF 里到底该怎么落地从生成到识别的完整链路很多做 C# 桌面端的朋友第一次接到「二维码」需求时脑子里蹦出来的往往是「调个库不就完了」。真动手才发现WPF 里生成二维码要处理图片渲染、DPI 缩放、保存路径识别环节更麻烦摄像头帧率、图像预处理、解码失败率每一项都能让 demo 从「跑通」变成「翻车」。这个标题讲的就是一条完整链路在 WPF 应用里用 C# 把文本生成二维码图片再从图片或摄像头画面里把内容识别出来。它适合两类人——一类是刚接触 WPF 图像处理的开发者想找一个能直接复现的最小闭环另一类是有一定经验、但被识别率或部署问题卡住的工程师想看清参数边界和踩坑点。下面按「先能生成、再能识别、最后能稳定」的顺序拆开讲每一步都落到可抄的代码和可调的参数上。2. 生成二维码选库、画图、存文件的三步走2.1 为什么我优先选 ZXing.Net 而不是自己画矩阵二维码生成的核心是把字符串按 QR Code 标准编码成黑白模块矩阵再渲染成位图。自己实现编码算法不是不行但纠错码、掩码选择、版本自适应这些细节足够写一本书实际项目里没人这么干。常见做法是用成熟库C# 生态里 ZXing.Net 是覆盖面最广的一个它同时支持生成和识别API 也稳定。选它的理由很直接生成侧支持自定义纠错级别和尺寸识别侧支持从 Bitmap 和裸像素数据解码一套依赖解决两个方向省得引入两个库还要处理类型转换。在 WPF 项目里通过 NuGet 引入后生成二维码只需要三步构造编码器、写入内容、渲染成 WriteableBitmap 或直接存成 PNG。这里有个容易忽略的点——WPF 的 Image 控件吃的是 BitmapSource而 ZXing 默认输出的是 System.Drawing.Bitmap两者之间需要转换。如果你不想引入 System.Drawing.Common 的跨平台依赖也可以直接用 ZXing 的裸矩阵自己填像素后面会给这种写法。2.2 最小可运行代码文本转二维码并显示在 Image 控件上下面这段代码演示从字符串到 WPF Image 控件的完整过程包含矩阵填充和像素格式转换不依赖 System.Drawing。using System; using System.Windows; using System.Windows.Media; using System.Windows.Media.Imaging; using ZXing; using ZXing.QrCode; using ZXing.QrCode.Internal; public static class QrGenerator { /// summary /// 生成二维码并返回可直接绑定到 WPF Image 的 BitmapSource /// /summary /// param namecontent要编码的文本建议不超过 1000 字符/param /// param namepixelsPerModule每个模块占多少像素决定最终图片大小/param /// param nameerrorCorrection纠错级别L/M/Q/H越高越抗污损但容量越小/param public static BitmapSource Generate(string content, int pixelsPerModule 10, ErrorCorrectionLevel errorCorrection null) { // 1. 配置编码参数 var options new QrCodeEncodingOptions { DisableECI true, CharacterSet UTF-8, // 中文必须显式指定 UTF-8 ErrorCorrection errorCorrection ?? ErrorCorrectionLevel.M, Margin 2 // 静默区单位是模块数太小会影响识别 }; var writer new BarcodeWriterPixelData { Format BarcodeFormat.QR_CODE, Options options }; // 2. 生成裸像素数据每个像素 4 字节 BGRA var pixelData writer.Write(content); int width pixelData.Width; int height pixelData.Height; // 3. 按 pixelsPerModule 放大避免小图在 WPF 里被拉伸模糊 int scaledWidth width * pixelsPerModule; int scaledHeight height * pixelsPerModule; int stride scaledWidth * 4; byte[] scaled new byte[scaledHeight * stride]; for (int y 0; y scaledHeight; y) { int srcY y / pixelsPerModule; for (int x 0; x scaledWidth; x) { int srcX x / pixelsPerModule; int srcIndex (srcY * width srcX) * 4; int dstIndex y * stride x * 4; scaled[dstIndex] pixelData.Pixels[srcIndex]; // B scaled[dstIndex 1] pixelData.Pixels[srcIndex 1]; // G scaled[dstIndex 2] pixelData.Pixels[srcIndex 2]; // R scaled[dstIndex 3] pixelData.Pixels[srcIndex 3]; // A } } // 4. 构造 WPF 可用的 BitmapSource var bitmap BitmapSource.Create( scaledWidth, scaledHeight, 96, 96, // DPI桌面端用 96 即可 PixelFormats.Bgra32, null, scaled, stride); bitmap.Freeze(); // 冻结后跨线程访问更安全 return bitmap; } }逻辑说明第一步用QrCodeEncodingOptions控制编码行为CharacterSet设成 UTF-8 是中文不乱码的关键默认值在某些版本里是 ISO-8859-1直接写中文会抛异常或生成乱码。第二步用BarcodeWriterPixelData拿到裸像素而不是直接拿 Bitmap这样能避开 System.Drawing 依赖。第三步手动放大因为 ZXing 输出的原始尺寸是「模块数 × 模块数」通常只有几十像素直接显示会糊放大后每个模块边界清晰识别端也更容易处理。第四步构造BitmapSource并冻结冻结后的对象可以在后台线程使用避免 UI 线程卡顿。参数说明pixelsPerModule建议 8 到 12太小在低分辨率屏幕上会糊太大浪费内存ErrorCorrection默认用 M 级别大约能容忍 15% 污损如果二维码要印在容易磨损的标签上就升到 Q 或 H但内容容量会下降Margin是静默区宽度标准要求至少 4 个模块设成 2 在干净背景下也能识别但扫描环境复杂时建议改回 4。2.3 保存成 PNG 与 DPI 的坑生成之后通常要存文件。WPF 里用PngBitmapEncoder保存代码很短但 DPI 设置有个血泪经验如果BitmapSource.Create时 DPI 写 96保存出来的 PNG 在 Windows 照片查看器里显示正常但插入 Word 或打印时会按 96 DPI 换算物理尺寸可能变得很小。解决办法是在创建时把 DPI 设成 300或者保存前用TransformedBitmap缩放。下面这段保存代码把 DPI 显式写成 300适合需要打印的场景。public static void SaveAsPng(BitmapSource bitmap, string filePath) { // 如果原图是 96 DPI先转成 300 DPI 再保存打印时尺寸才正确 var safeBitmap bitmap; if (Math.Abs(bitmap.DpiX - 300) 0.1) { double scale 300.0 / bitmap.DpiX; var transform new ScaleTransform(scale, scale); safeBitmap new TransformedBitmap(bitmap, transform); } var encoder new PngBitmapEncoder(); encoder.Frames.Add(BitmapFrame.Create(safeBitmap)); using (var stream System.IO.File.Create(filePath)) { encoder.Save(stream); } }逻辑说明TransformedBitmap按比例放大像素同时把 DPI 元数据带到 300这样打印时物理尺寸符合预期。参数上scale由目标 DPI 除以原 DPI 得到如果原图已经是 300 就跳过避免二次缩放引入模糊。3. 识别二维码从静态图片到摄像头帧的两种路径3.1 静态图片识别解码器配置与常见失败原因识别静态图片比生成简单但失败率往往更高原因多半在图像质量上。ZXing.Net 的BarcodeReader支持从BitmapSource解码但 WPF 的BitmapSource不能直接喂给它需要先转成像素数组或System.Drawing.Bitmap。为了保持不依赖 System.Drawing我一般把BitmapSource拷成byte[]再构造RGBLuminanceSource。下面这段代码演示从文件路径识别二维码内容。using System.Windows.Media.Imaging; using ZXing; using ZXing.Common; public static string DecodeFromFile(string filePath) { // 1. 以只读方式加载避免文件锁 var bitmap new BitmapImage(); bitmap.BeginInit(); bitmap.CacheOption BitmapCacheOption.OnLoad; bitmap.UriSource new Uri(filePath); bitmap.EndInit(); bitmap.Freeze(); // 2. 转成 BGRA 字节数组 int width bitmap.PixelWidth; int height bitmap.PixelHeight; int stride width * 4; byte[] pixels new byte[height * stride]; bitmap.CopyPixels(pixels, stride, 0); // 3. 构造亮度源ZXing 只关心灰度这里按加权公式转 var luminance new RGBLuminanceSource(pixels, width, height, RGBLuminanceSource.BitmapFormat.BGRA32); var reader new BarcodeReader { Options new DecodingOptions { TryHarder true, // 开启深度扫描提高小图识别率 PossibleFormats new[] { BarcodeFormat.QR_CODE }, CharacterSet UTF-8 } }; var result reader.Decode(luminance); return result?.Text; }逻辑说明第一步用BitmapCacheOption.OnLoad确保文件句柄及时释放否则后续想覆盖保存会报占用。第二步CopyPixels拿到 BGRA 数据注意 stride 是每行字节数可能大于宽度乘 4这里因为格式固定所以直接算。第三步RGBLuminanceSource把彩色转灰度ZXing 内部再做二值化。TryHarder打开后会尝试更多二值化策略代价是耗时增加静态图片场景可以放心开。参数说明PossibleFormats限定为 QR_CODE 能减少误判如果同时要识别条形码就加上对应格式CharacterSet同样要设 UTF-8否则中文内容解出来是乱码。如果识别失败先检查图片是否太小建议二维码区域至少 100×100 像素、是否有大面积反光、静默区是否被裁掉。3.2 摄像头实时识别帧采样与性能平衡摄像头识别是 demo 里最容易翻车的部分。常见做法是用MediaCapture或第三方库取帧每帧都送去解码结果 CPU 跑满、画面卡顿。我的经验是不要每帧都解按固定间隔采样比如每 200 毫秒解一次同时把解码放到后台线程。下面这段伪代码展示采样逻辑取帧部分因设备差异大用注释标出替换点。private DateTime _lastDecodeTime DateTime.MinValue; private readonly TimeSpan _decodeInterval TimeSpan.FromMilliseconds(200); private void OnFrameArrived(object sender, FrameEventArgs e) { // 控制采样频率避免每帧都解码拖垮 UI if (DateTime.Now - _lastDecodeTime _decodeInterval) return; _lastDecodeTime DateTime.Now; // 取当前帧的像素数据不同采集库 API 不同这里用占位方法 byte[] pixels e.GetBgraPixels(out int width, out int height); if (pixels null) return; // 丢到线程池解码不阻塞采集回调 System.Threading.Tasks.Task.Run(() { var luminance new RGBLuminanceSource(pixels, width, height, RGBLuminanceSource.BitmapFormat.BGRA32); var reader new BarcodeReader { Options new DecodingOptions { TryHarder false, // 实时场景关掉优先速度 PossibleFormats new[] { BarcodeFormat.QR_CODE }, CharacterSet UTF-8 } }; var result reader.Decode(luminance); if (result ! null) { // 回到 UI 线程更新结果 Dispatcher.Invoke(() ResultText.Text result.Text); } }); }逻辑说明采样间隔 200 毫秒是折中值人眼感觉不到明显延迟CPU 占用也能接受。TryHarder在实时场景必须关掉否则单帧解码可能超过 100 毫秒采样再快也没用。解码放线程池是为了不阻塞采集回调否则画面会掉帧。结果回 UI 线程用Dispatcher.Invoke直接跨线程改控件会抛异常。参数说明_decodeInterval可以根据设备性能调整低端摄像头可以放宽到 300 到 500 毫秒如果识别距离远二维码在画面里占比小可以先把感兴趣区域裁出来再解码减少无效计算。裁剪区域一般取画面中心 60% 到 80%具体看摄像头视野。3.3 图像预处理什么时候该做什么时候是过度设计网上很多教程一上来就教灰度化、二值化、去噪实际在 ZXing 内部已经做了自适应二值化额外预处理未必提升识别率反而可能引入新问题。我的判断标准是如果原始帧在肉眼看来清晰、对比度正常直接送解码只有在逆光、反光、模糊三种情况下才考虑预处理。逆光可以试直方图均衡化反光可以试局部阈值模糊则基本无解只能调焦距或缩短曝光。预处理代码不难但每加一步就多一层参数要调demo 阶段建议先不做等遇到具体问题再针对性加。4. 避坑与排查二维码 demo 最容易翻车的五个点4.1 中文内容生成后识别出来是乱码现象生成时输入中文识别结果变成问号或乱码。原因编码器和解码器的CharacterSet不一致或者其中一方没显式设置用了默认的 ISO-8859-1。解决生成侧QrCodeEncodingOptions.CharacterSet和解码侧DecodingOptions.CharacterSet都写成UTF-8两处缺一不可。如果内容里还有 emojiUTF-8 也能覆盖但部分旧版本库对四字节字符支持不完整建议先测试。4.2 生成的二维码在 Image 控件里显示模糊现象二维码能识别但显示出来边缘发虚。原因BitmapSource的 DPI 和 Image 控件的实际显示尺寸不匹配WPF 做了插值缩放。解决生成时把pixelsPerModule调大让原始像素尺寸接近或超过显示尺寸或者在 Image 上设StretchNone并配合SnapsToDevicePixelsTrue。如果必须缩放用RenderOptions.SetBitmapScalingMode(image, BitmapScalingMode.NearestNeighbor)关闭平滑插值。4.3 摄像头识别延迟高、画面卡顿现象一开识别预览画面就掉帧。原因解码在采集回调线程里同步执行单帧耗时超过帧间隔。解决按 3.2 节的采样加线程池方案改同时确认TryHarder是关的。如果还卡检查像素数据拷贝是否每帧都分配大数组可以复用缓冲区减少 GC 压力。4.4 保存的 PNG 打印出来尺寸不对现象屏幕上看着正常打印或插入文档后二维码变得很小。原因PNG 的 DPI 元数据是 96打印软件按 96 DPI 换算物理尺寸。解决保存前把 DPI 转成 300参考 2.3 节的SaveAsPng。如果只是屏幕展示不改也没问题但涉及打印就一定要改。4.5 识别率时高时低同一张图有时成功有时失败现象同一张二维码图片多次调用解码偶尔返回 null。原因TryHarder关闭时二值化策略单一对光照不均的图片不稳定或者图片加载时被 WPF 做了缩放。解决静态图片场景打开TryHarder确认BitmapImage的DecodePixelWidth没有设置否则会先缩放再解码细节丢失。如果图片来自网络先存本地再解码避免流读取不完整。5. 进阶技巧把识别结果用起来与参数调优的取舍走到这里生成和识别的基本闭环已经通了。实际项目里还有两件事值得做一是把识别结果结构化比如二维码内容是 JSON 时直接反序列化省去手动解析二是给解码加超时和重试避免单帧异常拖垮整个流程。下面这段代码演示带超时的解码封装用Task.WhenAny控制最长等待时间超时后返回 null调用方可以决定是否重试。public static async Taskstring DecodeWithTimeout(byte[] pixels, int width, int height, int timeoutMs 300) { var decodeTask Task.Run(() { var luminance new RGBLuminanceSource(pixels, width, height, RGBLuminanceSource.BitmapFormat.BGRA32); var reader new BarcodeReader { Options new DecodingOptions { TryHarder true, PossibleFormats new[] { BarcodeFormat.QR_CODE }, CharacterSet UTF-8 } }; return reader.Decode(luminance)?.Text; }); var completed await Task.WhenAny(decodeTask, Task.Delay(timeoutMs)); if (completed decodeTask) return await decodeTask; return null; // 超时调用方决定是否重试或跳过 }逻辑说明把解码包进Task.Run再用Task.WhenAny和Task.Delay赛跑谁先完成用谁。超时返回 null 而不是抛异常调用方逻辑更简单。参数timeoutMs默认 300 毫秒静态图片可以放宽到 1000实时场景建议不超过 200否则会积压任务。关于参数调优我的习惯是先固定ErrorCorrection为 M、pixelsPerModule为 10、TryHarder按场景开关这三个是影响最大的。调优顺序是先保证生成侧清晰放大倍数够、静默区够再调识别侧TryHarder、格式限定最后才考虑预处理。反过来先加预处理往往调了半天发现是生成侧尺寸太小白费功夫。另外如果二维码要印在深色背景上记得把前景色和背景色反过来ZXing 默认前景黑背景白反色后需要确认解码器是否支持部分版本对反色二维码识别率会下降最好实测。最后说一个我踩过的坑早期做 demo 时把解码放在 UI 线程结果摄像头一开界面就假死还以为是库的性能问题查了半天才发现是线程模型没搞对。从那以后凡是涉及图像解码我一律先丢后台线程再考虑优化算法。希望这些经验能帮你少走一段弯路把二维码这个看似简单的功能真正做稳。本文还有配套的精品资源点击获取
简介这份资源是面向C#与WPF开发者的二维码生成与识别示例项目适合希望快速在桌面端集成扫码功能的初中级开发者。项目以Zxing.Net为核心通过BarcodeWriter与QrCodeEncodingOptions完成二维码生成并演示将位图绑定到WPF的Image控件显示识别部分则结合多媒体处理库从摄像头或图片中读取二维码内容覆盖生成与识别两条完整链路。压缩包共148个文件约22.48MB以35个dll、31个pdb、29个xml等依赖与调试文件为主另有12个cs源码、2个xaml界面文件、2个exe可执行程序及sln、csproj等工程文件结构完整可直接编译运行。目前已有1002人学习下载。读者可据此掌握二维码编码参数设置、UI绑定与图像解码的整合思路并参考工程组织方式快速搭建自己的扫码应用。1. 二维码在 WPF 里到底该怎么落地从生成到识别的完整链路很多做 C# 桌面端的朋友第一次接到「二维码」需求时脑子里蹦出来的往往是「调个库不就完了」。真动手才发现WPF 里生成二维码要处理图片渲染、DPI 缩放、保存路径识别环节更麻烦摄像头帧率、图像预处理、解码失败率每一项都能让 demo 从「跑通」变成「翻车」。这个标题讲的就是一条完整链路在 WPF 应用里用 C# 把文本生成二维码图片再从图片或摄像头画面里把内容识别出来。它适合两类人——一类是刚接触 WPF 图像处理的开发者想找一个能直接复现的最小闭环另一类是有一定经验、但被识别率或部署问题卡住的工程师想看清参数边界和踩坑点。下面按「先能生成、再能识别、最后能稳定」的顺序拆开讲每一步都落到可抄的代码和可调的参数上。2. 生成二维码选库、画图、存文件的三步走2.1 为什么我优先选 ZXing.Net 而不是自己画矩阵二维码生成的核心是把字符串按 QR Code 标准编码成黑白模块矩阵再渲染成位图。自己实现编码算法不是不行但纠错码、掩码选择、版本自适应这些细节足够写一本书实际项目里没人这么干。常见做法是用成熟库C# 生态里 ZXing.Net 是覆盖面最广的一个它同时支持生成和识别API 也稳定。选它的理由很直接生成侧支持自定义纠错级别和尺寸识别侧支持从 Bitmap 和裸像素数据解码一套依赖解决两个方向省得引入两个库还要处理类型转换。在 WPF 项目里通过 NuGet 引入后生成二维码只需要三步构造编码器、写入内容、渲染成 WriteableBitmap 或直接存成 PNG。这里有个容易忽略的点——WPF 的 Image 控件吃的是 BitmapSource而 ZXing 默认输出的是 System.Drawing.Bitmap两者之间需要转换。如果你不想引入 System.Drawing.Common 的跨平台依赖也可以直接用 ZXing 的裸矩阵自己填像素后面会给这种写法。2.2 最小可运行代码文本转二维码并显示在 Image 控件上下面这段代码演示从字符串到 WPF Image 控件的完整过程包含矩阵填充和像素格式转换不依赖 System.Drawing。using System; using System.Windows; using System.Windows.Media; using System.Windows.Media.Imaging; using ZXing; using ZXing.QrCode; using ZXing.QrCode.Internal; public static class QrGenerator { /// summary /// 生成二维码并返回可直接绑定到 WPF Image 的 BitmapSource /// /summary /// param namecontent要编码的文本建议不超过 1000 字符/param /// param namepixelsPerModule每个模块占多少像素决定最终图片大小/param /// param nameerrorCorrection纠错级别L/M/Q/H越高越抗污损但容量越小/param public static BitmapSource Generate(string content, int pixelsPerModule 10, ErrorCorrectionLevel errorCorrection null) { // 1. 配置编码参数 var options new QrCodeEncodingOptions { DisableECI true, CharacterSet UTF-8, // 中文必须显式指定 UTF-8 ErrorCorrection errorCorrection ?? ErrorCorrectionLevel.M, Margin 2 // 静默区单位是模块数太小会影响识别 }; var writer new BarcodeWriterPixelData { Format BarcodeFormat.QR_CODE, Options options }; // 2. 生成裸像素数据每个像素 4 字节 BGRA var pixelData writer.Write(content); int width pixelData.Width; int height pixelData.Height; // 3. 按 pixelsPerModule 放大避免小图在 WPF 里被拉伸模糊 int scaledWidth width * pixelsPerModule; int scaledHeight height * pixelsPerModule; int stride scaledWidth * 4; byte[] scaled new byte[scaledHeight * stride]; for (int y 0; y scaledHeight; y) { int srcY y / pixelsPerModule; for (int x 0; x scaledWidth; x) { int srcX x / pixelsPerModule; int srcIndex (srcY * width srcX) * 4; int dstIndex y * stride x * 4; scaled[dstIndex] pixelData.Pixels[srcIndex]; // B scaled[dstIndex 1] pixelData.Pixels[srcIndex 1]; // G scaled[dstIndex 2] pixelData.Pixels[srcIndex 2]; // R scaled[dstIndex 3] pixelData.Pixels[srcIndex 3]; // A } } // 4. 构造 WPF 可用的 BitmapSource var bitmap BitmapSource.Create( scaledWidth, scaledHeight, 96, 96, // DPI桌面端用 96 即可 PixelFormats.Bgra32, null, scaled, stride); bitmap.Freeze(); // 冻结后跨线程访问更安全 return bitmap; } }逻辑说明第一步用QrCodeEncodingOptions控制编码行为CharacterSet设成 UTF-8 是中文不乱码的关键默认值在某些版本里是 ISO-8859-1直接写中文会抛异常或生成乱码。第二步用BarcodeWriterPixelData拿到裸像素而不是直接拿 Bitmap这样能避开 System.Drawing 依赖。第三步手动放大因为 ZXing 输出的原始尺寸是「模块数 × 模块数」通常只有几十像素直接显示会糊放大后每个模块边界清晰识别端也更容易处理。第四步构造BitmapSource并冻结冻结后的对象可以在后台线程使用避免 UI 线程卡顿。参数说明pixelsPerModule建议 8 到 12太小在低分辨率屏幕上会糊太大浪费内存ErrorCorrection默认用 M 级别大约能容忍 15% 污损如果二维码要印在容易磨损的标签上就升到 Q 或 H但内容容量会下降Margin是静默区宽度标准要求至少 4 个模块设成 2 在干净背景下也能识别但扫描环境复杂时建议改回 4。2.3 保存成 PNG 与 DPI 的坑生成之后通常要存文件。WPF 里用PngBitmapEncoder保存代码很短但 DPI 设置有个血泪经验如果BitmapSource.Create时 DPI 写 96保存出来的 PNG 在 Windows 照片查看器里显示正常但插入 Word 或打印时会按 96 DPI 换算物理尺寸可能变得很小。解决办法是在创建时把 DPI 设成 300或者保存前用TransformedBitmap缩放。下面这段保存代码把 DPI 显式写成 300适合需要打印的场景。public static void SaveAsPng(BitmapSource bitmap, string filePath) { // 如果原图是 96 DPI先转成 300 DPI 再保存打印时尺寸才正确 var safeBitmap bitmap; if (Math.Abs(bitmap.DpiX - 300) 0.1) { double scale 300.0 / bitmap.DpiX; var transform new ScaleTransform(scale, scale); safeBitmap new TransformedBitmap(bitmap, transform); } var encoder new PngBitmapEncoder(); encoder.Frames.Add(BitmapFrame.Create(safeBitmap)); using (var stream System.IO.File.Create(filePath)) { encoder.Save(stream); } }逻辑说明TransformedBitmap按比例放大像素同时把 DPI 元数据带到 300这样打印时物理尺寸符合预期。参数上scale由目标 DPI 除以原 DPI 得到如果原图已经是 300 就跳过避免二次缩放引入模糊。3. 识别二维码从静态图片到摄像头帧的两种路径3.1 静态图片识别解码器配置与常见失败原因识别静态图片比生成简单但失败率往往更高原因多半在图像质量上。ZXing.Net 的BarcodeReader支持从BitmapSource解码但 WPF 的BitmapSource不能直接喂给它需要先转成像素数组或System.Drawing.Bitmap。为了保持不依赖 System.Drawing我一般把BitmapSource拷成byte[]再构造RGBLuminanceSource。下面这段代码演示从文件路径识别二维码内容。using System.Windows.Media.Imaging; using ZXing; using ZXing.Common; public static string DecodeFromFile(string filePath) { // 1. 以只读方式加载避免文件锁 var bitmap new BitmapImage(); bitmap.BeginInit(); bitmap.CacheOption BitmapCacheOption.OnLoad; bitmap.UriSource new Uri(filePath); bitmap.EndInit(); bitmap.Freeze(); // 2. 转成 BGRA 字节数组 int width bitmap.PixelWidth; int height bitmap.PixelHeight; int stride width * 4; byte[] pixels new byte[height * stride]; bitmap.CopyPixels(pixels, stride, 0); // 3. 构造亮度源ZXing 只关心灰度这里按加权公式转 var luminance new RGBLuminanceSource(pixels, width, height, RGBLuminanceSource.BitmapFormat.BGRA32); var reader new BarcodeReader { Options new DecodingOptions { TryHarder true, // 开启深度扫描提高小图识别率 PossibleFormats new[] { BarcodeFormat.QR_CODE }, CharacterSet UTF-8 } }; var result reader.Decode(luminance); return result?.Text; }逻辑说明第一步用BitmapCacheOption.OnLoad确保文件句柄及时释放否则后续想覆盖保存会报占用。第二步CopyPixels拿到 BGRA 数据注意 stride 是每行字节数可能大于宽度乘 4这里因为格式固定所以直接算。第三步RGBLuminanceSource把彩色转灰度ZXing 内部再做二值化。TryHarder打开后会尝试更多二值化策略代价是耗时增加静态图片场景可以放心开。参数说明PossibleFormats限定为 QR_CODE 能减少误判如果同时要识别条形码就加上对应格式CharacterSet同样要设 UTF-8否则中文内容解出来是乱码。如果识别失败先检查图片是否太小建议二维码区域至少 100×100 像素、是否有大面积反光、静默区是否被裁掉。3.2 摄像头实时识别帧采样与性能平衡摄像头识别是 demo 里最容易翻车的部分。常见做法是用MediaCapture或第三方库取帧每帧都送去解码结果 CPU 跑满、画面卡顿。我的经验是不要每帧都解按固定间隔采样比如每 200 毫秒解一次同时把解码放到后台线程。下面这段伪代码展示采样逻辑取帧部分因设备差异大用注释标出替换点。private DateTime _lastDecodeTime DateTime.MinValue; private readonly TimeSpan _decodeInterval TimeSpan.FromMilliseconds(200); private void OnFrameArrived(object sender, FrameEventArgs e) { // 控制采样频率避免每帧都解码拖垮 UI if (DateTime.Now - _lastDecodeTime _decodeInterval) return; _lastDecodeTime DateTime.Now; // 取当前帧的像素数据不同采集库 API 不同这里用占位方法 byte[] pixels e.GetBgraPixels(out int width, out int height); if (pixels null) return; // 丢到线程池解码不阻塞采集回调 System.Threading.Tasks.Task.Run(() { var luminance new RGBLuminanceSource(pixels, width, height, RGBLuminanceSource.BitmapFormat.BGRA32); var reader new BarcodeReader { Options new DecodingOptions { TryHarder false, // 实时场景关掉优先速度 PossibleFormats new[] { BarcodeFormat.QR_CODE }, CharacterSet UTF-8 } }; var result reader.Decode(luminance); if (result ! null) { // 回到 UI 线程更新结果 Dispatcher.Invoke(() ResultText.Text result.Text); } }); }逻辑说明采样间隔 200 毫秒是折中值人眼感觉不到明显延迟CPU 占用也能接受。TryHarder在实时场景必须关掉否则单帧解码可能超过 100 毫秒采样再快也没用。解码放线程池是为了不阻塞采集回调否则画面会掉帧。结果回 UI 线程用Dispatcher.Invoke直接跨线程改控件会抛异常。参数说明_decodeInterval可以根据设备性能调整低端摄像头可以放宽到 300 到 500 毫秒如果识别距离远二维码在画面里占比小可以先把感兴趣区域裁出来再解码减少无效计算。裁剪区域一般取画面中心 60% 到 80%具体看摄像头视野。3.3 图像预处理什么时候该做什么时候是过度设计网上很多教程一上来就教灰度化、二值化、去噪实际在 ZXing 内部已经做了自适应二值化额外预处理未必提升识别率反而可能引入新问题。我的判断标准是如果原始帧在肉眼看来清晰、对比度正常直接送解码只有在逆光、反光、模糊三种情况下才考虑预处理。逆光可以试直方图均衡化反光可以试局部阈值模糊则基本无解只能调焦距或缩短曝光。预处理代码不难但每加一步就多一层参数要调demo 阶段建议先不做等遇到具体问题再针对性加。4. 避坑与排查二维码 demo 最容易翻车的五个点4.1 中文内容生成后识别出来是乱码现象生成时输入中文识别结果变成问号或乱码。原因编码器和解码器的CharacterSet不一致或者其中一方没显式设置用了默认的 ISO-8859-1。解决生成侧QrCodeEncodingOptions.CharacterSet和解码侧DecodingOptions.CharacterSet都写成UTF-8两处缺一不可。如果内容里还有 emojiUTF-8 也能覆盖但部分旧版本库对四字节字符支持不完整建议先测试。4.2 生成的二维码在 Image 控件里显示模糊现象二维码能识别但显示出来边缘发虚。原因BitmapSource的 DPI 和 Image 控件的实际显示尺寸不匹配WPF 做了插值缩放。解决生成时把pixelsPerModule调大让原始像素尺寸接近或超过显示尺寸或者在 Image 上设StretchNone并配合SnapsToDevicePixelsTrue。如果必须缩放用RenderOptions.SetBitmapScalingMode(image, BitmapScalingMode.NearestNeighbor)关闭平滑插值。4.3 摄像头识别延迟高、画面卡顿现象一开识别预览画面就掉帧。原因解码在采集回调线程里同步执行单帧耗时超过帧间隔。解决按 3.2 节的采样加线程池方案改同时确认TryHarder是关的。如果还卡检查像素数据拷贝是否每帧都分配大数组可以复用缓冲区减少 GC 压力。4.4 保存的 PNG 打印出来尺寸不对现象屏幕上看着正常打印或插入文档后二维码变得很小。原因PNG 的 DPI 元数据是 96打印软件按 96 DPI 换算物理尺寸。解决保存前把 DPI 转成 300参考 2.3 节的SaveAsPng。如果只是屏幕展示不改也没问题但涉及打印就一定要改。4.5 识别率时高时低同一张图有时成功有时失败现象同一张二维码图片多次调用解码偶尔返回 null。原因TryHarder关闭时二值化策略单一对光照不均的图片不稳定或者图片加载时被 WPF 做了缩放。解决静态图片场景打开TryHarder确认BitmapImage的DecodePixelWidth没有设置否则会先缩放再解码细节丢失。如果图片来自网络先存本地再解码避免流读取不完整。5. 进阶技巧把识别结果用起来与参数调优的取舍走到这里生成和识别的基本闭环已经通了。实际项目里还有两件事值得做一是把识别结果结构化比如二维码内容是 JSON 时直接反序列化省去手动解析二是给解码加超时和重试避免单帧异常拖垮整个流程。下面这段代码演示带超时的解码封装用Task.WhenAny控制最长等待时间超时后返回 null调用方可以决定是否重试。public static async Taskstring DecodeWithTimeout(byte[] pixels, int width, int height, int timeoutMs 300) { var decodeTask Task.Run(() { var luminance new RGBLuminanceSource(pixels, width, height, RGBLuminanceSource.BitmapFormat.BGRA32); var reader new BarcodeReader { Options new DecodingOptions { TryHarder true, PossibleFormats new[] { BarcodeFormat.QR_CODE }, CharacterSet UTF-8 } }; return reader.Decode(luminance)?.Text; }); var completed await Task.WhenAny(decodeTask, Task.Delay(timeoutMs)); if (completed decodeTask) return await decodeTask; return null; // 超时调用方决定是否重试或跳过 }逻辑说明把解码包进Task.Run再用Task.WhenAny和Task.Delay赛跑谁先完成用谁。超时返回 null 而不是抛异常调用方逻辑更简单。参数timeoutMs默认 300 毫秒静态图片可以放宽到 1000实时场景建议不超过 200否则会积压任务。关于参数调优我的习惯是先固定ErrorCorrection为 M、pixelsPerModule为 10、TryHarder按场景开关这三个是影响最大的。调优顺序是先保证生成侧清晰放大倍数够、静默区够再调识别侧TryHarder、格式限定最后才考虑预处理。反过来先加预处理往往调了半天发现是生成侧尺寸太小白费功夫。另外如果二维码要印在深色背景上记得把前景色和背景色反过来ZXing 默认前景黑背景白反色后需要确认解码器是否支持部分版本对反色二维码识别率会下降最好实测。最后说一个我踩过的坑早期做 demo 时把解码放在 UI 线程结果摄像头一开界面就假死还以为是库的性能问题查了半天才发现是线程模型没搞对。从那以后凡是涉及图像解码我一律先丢后台线程再考虑优化算法。希望这些经验能帮你少走一段弯路把二维码这个看似简单的功能真正做稳。本文还有配套的精品资源点击获取
