這段時間陸續(xù)給兩三個 Delphi 項目做了二維碼生成模塊需求都差不多離線狀態(tài)下錄入一串編號程序生成二維碼展示在界面上能保存成圖片文件歸檔。第一個項目我圖省事調(diào)了某個云接口把圖片拉回來結(jié)果部署環(huán)境沒外網(wǎng)項目差點延期。后面老老實實自己生成把整個流程跑通以后發(fā)現(xiàn)Delphi 里做這件事并不復雜難點反而在幾個容易被忽略的細節(jié)上——比如 PaintBox 繪制完以后怎么不閃保存時怎么保證掃得出來還有放到 Image 里顯示會不會莫名其妙被拉伸變形。這篇文章就把這套流程完整說一遍從二維碼生成的原理、PaintBox 畫圖、保存 PNG再到 Image 控件加載顯示連帶我在項目里踩過的坑一起寫出來。適合正在用 Delphi 做桌面客戶端、需要在本地生成和展示二維碼的小伙伴也適合想搞懂二維碼生成底層概念再自己動手寫的人。讀的時候可以開著 IDE 跟著敲代碼片段都是可以直接粘進項目的。1. 項目背景與需求拆解桌面端二維碼到底怎么用1.1 三種典型應用場景二維碼在桌面程序里出現(xiàn)最多的場景我總結(jié)下來就三類。第一類是設備資產(chǎn)標簽操作員錄入設備編號、型號、序列號程序生成二維碼要么直接打印到標簽紙上要么導出圖片歸檔。第二類是授權激活常見于工業(yè)軟件或?qū)I(yè)工具程序在離線環(huán)境下根據(jù)授權碼生成二維碼用戶拿手機 App 掃一下完成激活綁定這里數(shù)據(jù)完全不能出內(nèi)網(wǎng)。第三類是工序流轉(zhuǎn)產(chǎn)線操作員選擇工單號二維碼貼在物料流轉(zhuǎn)單上下一個工位掃碼讀取不需要額外的掃碼槍硬件手機就能頂上去。我做的某制造企業(yè) MES 客戶端就屬于第一類和第三類的結(jié)合體。操作員在界面上選中設備編號點擊按鈕之后二維碼立刻顯示在右側(cè)的 PaintBox 里同時保存成一個 PNG 文件放到共享目錄最后在下方 Image 控件里再預顯一次。整個流程看起來簡單但里面每一步都有選擇可以做錯尤其是后面要講的繪制和顯示問題。1.2 本地生成和外接接口怎么選做二維碼功能的第一道選擇題就是到底調(diào)用別人的接口還是自己本地生成。在線接口的優(yōu)勢很明顯代碼少圖片美觀人家還幫你處理了各種參數(shù)。但劣勢同樣明顯必須有外網(wǎng)、有接口限流、數(shù)據(jù)內(nèi)容會經(jīng)過第三方服務器這三條在工控和政企項目里通常都是硬傷。我第一版就是調(diào)接口開發(fā)時一切正常到了客戶現(xiàn)場發(fā)現(xiàn)生產(chǎn)網(wǎng)段根本沒有外網(wǎng)所有二維碼都拉不回來。后來改成本地生成才意識到二維碼生成本身就是一個純計算過程不涉及 OCR、不涉及大模型普通 CPU 計算一個 V40 的二維碼也就是幾十毫秒的事完全沒有必要依賴外部服務。所以我現(xiàn)在的建議很簡單桌面程序里做二維碼默認走本地生成除非你有批量生成幾萬張并且需要統(tǒng)一模板設計的需求才考慮外部服務。1.3 為什么是 PaintBox Image 這個組合Delphi 的 VCL 里能顯示圖形的東西很多但 PaintBox 和 Image 是分工不同的兩個控件。TPaintBox 是輕量級繪圖控件它本身不保存圖像數(shù)據(jù)只是在 OnPaint 事件觸發(fā)時把內(nèi)容畫到 Canvas 上適合動態(tài)計算出來的畫面。TImage 則是一個圖像容器有 Picture 屬性可以加載磁盤文件、TBitmap、TPngImage 等等適合靜態(tài)展示。不少人會偷懶直接在 TImage.Canvas 上畫二維碼我一開始也這么干過結(jié)果窗體一縮放、一遮擋TImage 上的內(nèi)容就被系統(tǒng)擦掉了因為它并不負責持久化繪制內(nèi)容。用 PaintBox 就清楚很多數(shù)據(jù)變了就調(diào)用 Invalidate 觸發(fā)重繪OnPaint 里統(tǒng)一處理邏輯上是閉環(huán)的。而 TImage 用來做最終結(jié)果展示和文件預覽分工干凈利落。2. 二維碼生成的底層邏輯先把矩陣搞清楚2.1 二維碼本質(zhì)上是一張位圖矩陣理解了底層再看代碼很多坑就能提前避開。QR Code 這個東西表面上是一張黑白相間的方塊圖實際上是一個行列固定的布爾矩陣黑色模塊代表 1白色模塊代表 0。這個矩陣里既有我們輸入的數(shù)據(jù)內(nèi)容也有定位圖形、校正圖形、時序圖形這些專門用于掃描定位的元素。所以二維碼生成庫的工作本質(zhì)就兩步一是把你的字符串編碼成符合 QR 規(guī)范的數(shù)據(jù)位流二是在內(nèi)存里拼出一個 rows * columns 的二維布爾數(shù)組。繪制環(huán)節(jié)完全不需要關心里面的編碼細節(jié)只需要拿著這個布爾數(shù)組把每個為 true 的格子畫成一個帶顏色的矩形就得到了肉眼可見的二維碼。這也是為什么 PaintBox 很適合做這件事它的 Canvas 畫矩形是基本操作。2.2 生成器在中間做了四件事如果你用封裝好的庫這些事都是透明的但知道一下沒有壞處至少調(diào)試的時候不會瞎猜。第一件事是數(shù)據(jù)分析檢查待編碼內(nèi)容屬于純數(shù)字、字母數(shù)字、字節(jié)還是漢字模式選擇最緊湊的編碼方式。第二件事是數(shù)據(jù)編碼把內(nèi)容變成比特流加入模式指示符、字符計數(shù)符和終止符。第三件事是生成糾錯碼這里用的是 Reed-Solomon 算法把原始數(shù)據(jù)按照設定的糾錯級別拆塊每塊生成糾錯碼這樣二維碼局部被遮擋或污損時依然能解出來。第四件事是把數(shù)據(jù)碼和糾錯碼按規(guī)則填入矩陣再執(zhí)行掩碼運算并寫入版本信息和格式信息。掩碼這一步可能很多人不知道它的目的不是加密而是讓生成出來的二維碼黑色模塊分布盡量均勻避免出現(xiàn)大面積的空白或密集方塊導致掃描器無法定位。整個過程標準文檔寫了幾十頁但你完全不需要自己實現(xiàn)開源社區(qū)早就把這塊固化成穩(wěn)定的庫了。2.3 版本、糾錯級別和參數(shù)選擇二維碼版本從 1 到 40版本越高矩陣越大容量越大。V1 是 21x21 的模塊每增加一個版本矩陣一邊增加 4 個模塊到 V40 是 177x177。同一個版本下容量還受糾錯級別影響。糾錯級別分 L、M、Q、H分別能容忍約 7%、15%、25%、30% 的碼字損壞。級別越高能存的有效內(nèi)容越少但抗污損能力越強。我的經(jīng)驗是普通業(yè)務場景選 M 級別就夠內(nèi)容比較短的比如鏈接、編號直接用 H 也不會虧。但是要注意內(nèi)容長度決定版本號版本越高矩陣越大如果顯示尺寸固定高版本的每個模塊像素就越小掃碼設備識別難度會上升。所以不要盲目追求大容量能短則短。另外還有一個參數(shù)容易被忽略就是靜區(qū)也就是二維碼周圍一圈空白的寬度。規(guī)范要求至少 4 個模塊寬實際測試下來少于這個值手機還能掃但工業(yè)掃碼槍很容易翻車。這個參數(shù)后面繪制和保存時會反復用到。3. 核心實現(xiàn)PaintBox 上把二維碼畫出來3.1 生成庫的選型和引入Delphi 生態(tài)里現(xiàn)成的二維碼生成方案不算多但有一款基于 ZXing 移植的開源庫相當能打純 Delphi 實現(xiàn)沒有第三方動態(tài)庫依賴可以在舊版本的 Delphi 里直接用。市面上還有 Delphi XE 自帶的某些組件以及各種個人封裝的單元但對比下來ZXing 移植版勝在編碼規(guī)范、支持多版本多糾錯級別、矩陣輸出接口清晰非常適合我們把繪制邏輯自己做一遍。引入方式很簡單下載源碼后把相關單元所在目錄加入 Project Manager 里的 Search Path 就行然后在你自己的單元 uses 里加上聲明。整個過程不裝包、不注冊組件和寫普通代碼完全一樣。我建議不要用那種直接把整張二維碼圖片生成好的重量級封裝因為項目里后續(xù)需求往往會有變動比如加 Logo、改靜區(qū)尺寸、只生成矩陣自己排版打印矩陣輸出的接口比圖片輸出接口好用得多。3.2 從字符串到矩陣再到 Canvas核心代碼看下面這段。首先生成器對象設置 Data 為要編碼的內(nèi)容Encoding 用字節(jié)模式這樣中文和特殊字符都能按 UTF-8 正確處理。QuietZone 設置為 4對應靜區(qū) 4 個模塊。ErrorCorrectionLevel 這里設成 1表示 M 級糾錯。隨后遍歷矩陣所有 IsBlack 為 true 的格子都畫成黑色矩形。type TFormQRCode class(TForm) PaintBox1: TPaintBox; btnGenerate: TButton; procedure btnGenerateClick(Sender: TObject); procedure FormCreate(Sender: TObject); private QRCore: TDelphiZXingQRCode; public procedure DrawMatrix(PBox: TPaintBox); end; implementation procedure TFormQRCode.FormCreate(Sender: TObject); begin QRCore : TDelphiZXingQRCode.Create; end; procedure TFormQRCode.btnGenerateClick(Sender: TObject); begin QRCore.Data : edtContent.Text; QRCore.Encoding : TQRCodeEncoding.qrEncodingByte; QRCore.QuietZone : 4; QRCore.ErrorCorrectionLevel : 1; PaintBox1.Invalidate; end; procedure TFormQRCode.DrawMatrix(PBox: TPaintBox); var Row, Col: Integer; ModuleSize, Margin: Integer; DrawWidth, DrawHeight: Integer; X, Y: Integer; begin ModuleSize : 8; Margin : ModuleSize * QRCore.QuietZone; DrawWidth : QRCore.Columns * ModuleSize Margin * 2; DrawHeight : QRCore.Rows * ModuleSize Margin * 2; PBox.Canvas.Brush.Color : clWhite; PBox.Canvas.FillRect(Rect(0, 0, DrawWidth, DrawHeight)); PBox.Canvas.Brush.Color : clBlack; for Row : 0 to QRCore.Rows - 1 do begin for Col : 0 to QRCore.Columns - 1 do begin if QRCore.IsBlack[Row, Col] then begin X : Margin Col * ModuleSize; Y : Margin Row * ModuleSize; PBox.Canvas.FillRect(Rect(X, Y, X ModuleSize, Y ModuleSize)); end; end; end; PBox.Width : DrawWidth; PBox.Height : DrawHeight; end;這段代碼里最關鍵的一個點就是繪制尺寸的計算。很多人直接把 PaintBox 撐滿整個窗體然后從左上角開始畫結(jié)果二維碼擠在角落靜區(qū)也沒有掃起來特別費勁。正確的做法是先根據(jù)矩陣列數(shù)和模塊尺寸算出總寬度再把整個繪制邏輯和 PaintBox 的寬高綁定。這樣無論內(nèi)容長短、版本高低二維碼都能居中占滿控件且四周留有標準的白邊。3.3 繪制參數(shù)調(diào)試模塊尺寸與靜區(qū)模塊尺寸選多大取決于二維碼最終要在哪看。如果只是在屏幕上展示模塊尺寸 6 到 8 像素很合適畫面干凈。如果還要打印到小標簽上那模塊尺寸建議按打印分辨率換算通常至少 4 個打印像素。模塊尺寸過小的直接后果是模塊與模塊之間幾乎沒有間隔黑白邊緣容易被打印機糊成一團。靜區(qū)在上面的代碼里由 QRCore.QuietZone 參數(shù)控制我固定設為 4。這里要提醒一點如果你自己實現(xiàn)繪制不要只在矩陣外邊留幾個像素就算靜區(qū)必須按模塊尺寸乘以靜區(qū)模塊數(shù)來計算。還有顏色選擇我堅持用純黑和純白不要為了 UI 美觀把前景改成深藍、深綠很多掃碼引擎對非標準黑色邊緣的容錯很差尤其是低端掃碼槍。如果想要“彩色二維碼”的效果更穩(wěn)妥的做法是先保存黑白底圖再通過位圖后處理給白色區(qū)域染色黑色模塊保持不動。4. 保存本地文件并加載到 Image 控件4.1 為什么要繞一層文件操作有朋友問既然已經(jīng)畫在 PaintBox 上了直接 Image1.Picture.Assign(PaintBox1.Canvas) 這種思路行不行答案是不行Canva 不是圖形對象不能直接賦值給 Picture。另外標題里的需求本來就要求“保存為本地文件并添加至 Image 控件中”這個文件是要拿來歸檔、打印、上傳服務端的不是臨時展示用。所以正確的鏈路是PaintBox 繪制完成后把它 Canvas 上的內(nèi)容拷貝到一個 TBitmap再由 TBitmap 轉(zhuǎn)成 TPngImage 保存成磁盤文件。保存完之后Image 控件再從磁盤加載這個 PNG。這樣文件有了展示也有了后面想對這個文件做二次處理比如加水印、壓縮、合并都有明確的操作對象。4.2 保存為 PNG 的具體實現(xiàn)下面的代碼把 PaintBox 的內(nèi)容拷貝到一個 24 位色的 Bitmap然后轉(zhuǎn)成 PNG 保存。注意拷貝之前一定要確保 PaintBox 已經(jīng)完成了一次完整的重繪否則 Canvas 上可能是舊數(shù)據(jù)或者空白。我習慣在生成函數(shù)里顯式調(diào)用一下 PaintBox1.Update()強制刷新整個窗口消息隊列確保畫布內(nèi)容落定。uses System.SysUtils, System.Classes, Vcl.Graphics, Vcl.Controls, Vcl.Forms, Vcl.ExtCtrls, Vcl.Imaging.pngimage; procedure SavePaintBoxToPng(PBox: TPaintBox; const AFileName: string); var Bmp: TBitmap; Png: TPngImage; W, H: Integer; begin W : PBox.Width; H : PBox.Height; if (W 0) or (H 0) then Exit; Bmp : TBitmap.Create; try Bmp.Width : W; Bmp.Height : H; Bmp.PixelFormat : pf24bit; Bmp.Canvas.Brush.Color : clWhite; Bmp.Canvas.FillRect(Rect(0, 0, W, H)); Bmp.Canvas.CopyRect( Rect(0, 0, W, H), PBox.Canvas, PBox.ClientRect); Png : TPngImage.Create; try Png.Assign(Bmp); Png.SaveToFile(AFileName); finally Png.Free; end; finally Bmp.Free; end; end;為什么不直接存 BMP 而轉(zhuǎn)成 PNG因為 PNG 是無損壓縮白底黑字的二維碼壓縮率極高存出來可能只有幾 KB而 BMP 一張 300x300 的圖就有二百多 KB。還有一點PNG 自帶 alpha 通道和像素格式信息后續(xù)如果用其他平臺處理兼容性比 BMP 好太多。JPG 格式我是強烈不建議用的JPG 是有損壓縮黑色模塊邊緣會出現(xiàn)顏色擴散和模糊一旦模塊較小掃碼識別率斷崖式下降后面講踩坑會細說。4.3 Image 控件顯示參數(shù)設置與優(yōu)化文件保存好之后加載進 Image 很簡單一行代碼Image1.Picture.LoadFromFile(AFileName);但這里有個新手高頻問題加載進去之后顯示只露出左上角一小塊二維碼其他部分都是空白。原因很簡單TImage 控件的 Stretch 屬性默認是 FalsePicture 多大它就按原始像素尺寸顯示如果控件比圖片小內(nèi)容就會被裁剪。解決辦法是把 Stretch 設為 TrueProportional 設為 TrueAutoSize 保持 False。Stretch True圖片自動縮放填滿控件區(qū)域。Proportional True縮放時保持寬高比不會把二維碼壓扁。Center True縮放后如果還有留白讓圖片居中。這三個屬性配合起來不管 Image 控件在窗體里被拉大還是縮小二維碼始終保持正方形且居中顯示。如果你想把二維碼放大預覽按鈕里動態(tài)設置 Image1.Width 和 Height 就行不需要重新生成文件。5. 我踩過的坑與排查速查5.1 繪制閃爍問題第一次把繪制代碼塞進 OnPaint 之后每次鼠標劃過窗體二維碼區(qū)域就瘋狂閃爍。原因是 PaintBox 背景先被清成白色再畫黑色模塊重繪頻率高的時候人眼就能捕捉到閃爍。解決方案有兩個一是 Form 的 DoubleBuffered 屬性設為 True讓 VCL 在內(nèi)存畫布上完成整套繪制后再一次性復制到屏幕二是減少不必要的重繪只有數(shù)據(jù)改變或控件尺寸改變時才調(diào)用 Invalidate。最穩(wěn)的做法是把繪制邏輯封裝成一個獨立函數(shù)按鈕點擊時設置矩陣數(shù)據(jù)、計算新尺寸最后才 Invalidate。不要在 OnPaint 里去讀取 Edit 框內(nèi)容、去請求網(wǎng)絡、去做 IO 操作。VCL 的繪制事件頻率遠比你想象的高窗口遮擋恢復、窗體拖動、最小化還原都會觸發(fā)干重活會導致界面明顯卡頓。還有一個小技巧如果某個界面里二維碼和其他控件布局比較復雜可以把 PaintBox 的 Enabled 設為 False。這樣它不響應鼠標交互從根本上減少無意義的刷新。5.2 DPI 縮放導致的鋸齒和虛化高 DPI 屏幕上VCL 窗體如果啟用了縮放控件會被整體放大。這時 PaintBox 的 Width、Height 是物理像素還是邏輯像素會直接影響繪制清晰度。我遇到過 150% 縮放下模塊邊緣出現(xiàn)灰邊、掃碼時識錯的情況原因是繪制時用了物理 Canvas但坐標計算基于邏輯尺寸黑色矩形被系統(tǒng)插值拉伸邊緣就虛了。解決思路是按當前 PixelsPerInch 動態(tài)調(diào)整 ModuleSize保證每個模塊的物理寬度是一個整數(shù)。簡單實現(xiàn)就是在繪制前讀取 Form 的 PixelsPerInch 和設計時基準值換算出實際模塊尺寸。另外保存文件的過程不受屏幕影響因為 Bitmap 尺寸完全由我們自己指定和屏幕分辨率無關。所以我建議屏幕展示圖稍虛沒關系保存出去的 PNG 一定要按固定邏輯尺寸生成保證掃描穩(wěn)定。5.3 保存出來的圖片掃不出來這個坑最隱蔽曾經(jīng)讓我排查了一個下午?，F(xiàn)象是 PaintBox 上掃碼正常保存成 PNG 后手機能掃但工業(yè)掃碼槍怎么都掃不到。后面對比兩張圖發(fā)現(xiàn)PaintBox 上顯示時周圍有空白的窗體背景實際上發(fā)揮了靜區(qū)作用而保存出來的 PNG 因為繪制時 Margin 設置為 0黑白矩陣貼邊生成掃碼槍讀不了。處理辦法就是本文前面反復提到的靜區(qū)參數(shù)QuietZone 至少 4保存時最外層 4 圈模塊寬度必須是空白。另外一個導致掃不出來的原因是保存尺寸太小如果二維碼是 V10 以上的版本模塊數(shù)量多但你把圖片整體壓到 100x100 像素那每個模塊平均只有不到 3 像素很多掃碼引擎直接放棄。我通常保證最終保存的圖片邊長不低于 400 像素模塊尺寸不小于 6 像素。5.4 二次加載與文件占用問題有業(yè)務需求是保存后立即把文件刪掉只讓圖片保留在 Image 控件里。實際操作時發(fā)現(xiàn)LoadFromFile 之后立刻 DeleteFile 會失敗有一部分原因是殺毒軟件還在掃描文件另一部分是 Image 控件內(nèi)部還沒有完全釋放文件句柄。穩(wěn)妥做法是先用 Try 包裝刪除確認延遲幾百毫秒如果真的必須馬上刪可以先把 Picture 保存到內(nèi)存里的 TBitmap再加載到 Image之后刪除文件就毫無障礙。另外一個相關問題是PaintBox 繪制的二維碼在窗體最小化再恢復之后OnPaint 觸發(fā)時會重新繪制這個前提下代碼里必須保證矩陣對象還在或者至少數(shù)據(jù)源還在。我見過有人直接把循環(huán)畫在 FormCreate 里結(jié)果窗口一刷新二維碼就消失了。正確做法是把矩陣生成結(jié)果緩存成一個字段OnPaint 只做繪制。5.5 常見問題速查表問題現(xiàn)象可能原因解決辦法二維碼繪制區(qū)域閃爍PaintBox 頻繁重繪未開雙緩沖Form.DoubleBuffered : True數(shù)據(jù)變化再 Invalidate高 DPI 下邊緣虛化邏輯尺寸與物理像素不匹配動態(tài)調(diào)整 ModuleSize用整數(shù)像素繪制保存后掃碼槍識別失敗靜區(qū)不足或模塊太小QuietZone 設為 4圖片邊長不低于 400 像素JPG 保存后無法掃描有損壓縮導致模塊邊緣模糊改用 PNG 保存Image 控件只顯示一角Stretch 為 False設置 Stretch / Proportional / Center 為 True窗體恢復后二維碼消失繪制邏輯不在 OnPaint 里緩存矩陣在 OnPaint 中統(tǒng)一繪制DeleteFile 刪除失敗圖片文件句柄未釋放加載到內(nèi)存后再刪除或延遲刪除內(nèi)容包含中文掃出來亂碼編碼模式或字符集不一致Encoding 使用字節(jié)模式UTF-8掃碼端約定一致6. 擴展從“能掃出來”到“掃得快、不翻車”6.1 給二維碼加 Logo 的注意事項很多客戶會要求在二維碼中間放一個企業(yè) Logo外觀上確實更有辨識度。實現(xiàn)上并不復雜在生成好的 Bitmap 正中央把 Logo 圖片按比例縮小后繪制上去。但核心問題是Logo 區(qū)域會遮擋一部分矩陣模塊QR 碼的 Reed-Solomon 糾錯能力能扛住一定程度的遮擋H 級別最高可以容忍約 30% 的碼字損壞。所以加 Logo 時必須把糾錯級別提升到 H設置 ErrorCorrectionLevel 為 3。Logo 尺寸建議不要超過二維碼邊長的四分之一也就是中心 1/4 區(qū)域內(nèi)的遮擋會被糾錯抵消。還有一個小細節(jié)Logo 圖案最好不要帶大面積的純黑或純白背景尤其是不能帶有與黑色模塊相似的規(guī)則紋理否則掃描器會誤判為數(shù)據(jù)模塊。我一般會把 Logo 周圍留一圈白邊再放到二維碼上。6.2 批量生成與文件命名策略如果業(yè)務上要一次生成幾十上百個二維碼循環(huán)調(diào)用生成庫即可每個二維碼生成計算量很小不需要額外開線程。但文件命名和日志管理值得提前規(guī)劃。我習慣用“前綴 日期 業(yè)務ID 隨機短碼”的方式比如 DEV20250615-0001-X7K3.png這樣歸檔時按前綴分類、按日期檢索、按業(yè)務ID關聯(lián)非常清晰。批量場景還有一個常見需求是連同二維碼一起導出 Excel 或 SQLite 記錄表生成后把文件名、內(nèi)容、生成時間、版本、糾錯級別一并記錄。千萬不要在文件名里放中文和特殊符號有些共享目錄和打印系統(tǒng)的編碼處理很弱極易出錯。文件名里的信息越少越穩(wěn)真正的內(nèi)容全部放在關聯(lián)表里。6.3 二維碼內(nèi)容協(xié)議與數(shù)據(jù)安全二維碼能承載的內(nèi)容有限但很多人會往里塞一長串 JSON結(jié)果版本飆到 V20 以上掃碼變慢打印變小純屬自找麻煩。我建議在系統(tǒng)設計階段就約定一個緊湊的內(nèi)容協(xié)議比如DEV|SN20250615|A1B2C3這種管道符分隔格式掃描端按固定順序拆分即可。如果是 URL就盡量用短鏈接服務或者干脆放一個跳轉(zhuǎn)參數(shù)別把完整參數(shù)往二維碼里塞。涉及敏感信息時直接在二維碼里放明文不可取。二維碼本身沒有任何加密能力貼在產(chǎn)品標簽上誰都能掃。要保護的內(nèi)容先做加密再編碼例如用 AES 加密后轉(zhuǎn) Base64掃描端再反向解密。如果項目允許離線驗簽可以在內(nèi)容尾部加一段 HMAC 簽名掃碼后校驗簽名確認數(shù)據(jù)未被篡改。這些內(nèi)容看起來超出“畫二維碼”的范疇但實際項目里往往和二維碼功能綁定出現(xiàn)提前設計能省掉后面改協(xié)議的痛苦。我自己在實際項目里踩得最慘的一次就是把二維碼當成普通圖片處理最后因為格式和靜區(qū)問題耽誤了上線。以后的習慣是內(nèi)容先定協(xié)議生成用矩陣接口繪制時算好模塊尺寸和靜區(qū)保存永遠走 PNG顯示用 Image 的三件套屬性。這套流程順下來不管是畫在 PaintBox、保存到本地文件、加載到 Image 控件還是后續(xù)加 Logo、批量導出、加密簽名都只是在這個骨架上加東西而已。 Delphi生成二維碼：PaintBox繪制、PNG保存與Image顯示
這段時間陸續(xù)給兩三個 Delphi 項目做了二維碼生成模塊需求都差不多離線狀態(tài)下錄入一串編號程序生成二維碼展示在界面上能保存成圖片文件歸檔。第一個項目我圖省事調(diào)了某個云接口把圖片拉回來結(jié)果部署環(huán)境沒外網(wǎng)項目差點延期。后面老老實實自己生成把整個流程跑通以后發(fā)現(xiàn)Delphi 里做這件事并不復雜難點反而在幾個容易被忽略的細節(jié)上——比如 PaintBox 繪制完以后怎么不閃保存時怎么保證掃得出來還有放到 Image 里顯示會不會莫名其妙被拉伸變形。這篇文章就把這套流程完整說一遍從二維碼生成的原理、PaintBox 畫圖、保存 PNG再到 Image 控件加載顯示連帶我在項目里踩過的坑一起寫出來。適合正在用 Delphi 做桌面客戶端、需要在本地生成和展示二維碼的小伙伴也適合想搞懂二維碼生成底層概念再自己動手寫的人。讀的時候可以開著 IDE 跟著敲代碼片段都是可以直接粘進項目的。1. 項目背景與需求拆解桌面端二維碼到底怎么用1.1 三種典型應用場景二維碼在桌面程序里出現(xiàn)最多的場景我總結(jié)下來就三類。第一類是設備資產(chǎn)標簽操作員錄入設備編號、型號、序列號程序生成二維碼要么直接打印到標簽紙上要么導出圖片歸檔。第二類是授權激活常見于工業(yè)軟件或?qū)I(yè)工具程序在離線環(huán)境下根據(jù)授權碼生成二維碼用戶拿手機 App 掃一下完成激活綁定這里數(shù)據(jù)完全不能出內(nèi)網(wǎng)。第三類是工序流轉(zhuǎn)產(chǎn)線操作員選擇工單號二維碼貼在物料流轉(zhuǎn)單上下一個工位掃碼讀取不需要額外的掃碼槍硬件手機就能頂上去。我做的某制造企業(yè) MES 客戶端就屬于第一類和第三類的結(jié)合體。操作員在界面上選中設備編號點擊按鈕之后二維碼立刻顯示在右側(cè)的 PaintBox 里同時保存成一個 PNG 文件放到共享目錄最后在下方 Image 控件里再預顯一次。整個流程看起來簡單但里面每一步都有選擇可以做錯尤其是后面要講的繪制和顯示問題。1.2 本地生成和外接接口怎么選做二維碼功能的第一道選擇題就是到底調(diào)用別人的接口還是自己本地生成。在線接口的優(yōu)勢很明顯代碼少圖片美觀人家還幫你處理了各種參數(shù)。但劣勢同樣明顯必須有外網(wǎng)、有接口限流、數(shù)據(jù)內(nèi)容會經(jīng)過第三方服務器這三條在工控和政企項目里通常都是硬傷。我第一版就是調(diào)接口開發(fā)時一切正常到了客戶現(xiàn)場發(fā)現(xiàn)生產(chǎn)網(wǎng)段根本沒有外網(wǎng)所有二維碼都拉不回來。后來改成本地生成才意識到二維碼生成本身就是一個純計算過程不涉及 OCR、不涉及大模型普通 CPU 計算一個 V40 的二維碼也就是幾十毫秒的事完全沒有必要依賴外部服務。所以我現(xiàn)在的建議很簡單桌面程序里做二維碼默認走本地生成除非你有批量生成幾萬張并且需要統(tǒng)一模板設計的需求才考慮外部服務。1.3 為什么是 PaintBox Image 這個組合Delphi 的 VCL 里能顯示圖形的東西很多但 PaintBox 和 Image 是分工不同的兩個控件。TPaintBox 是輕量級繪圖控件它本身不保存圖像數(shù)據(jù)只是在 OnPaint 事件觸發(fā)時把內(nèi)容畫到 Canvas 上適合動態(tài)計算出來的畫面。TImage 則是一個圖像容器有 Picture 屬性可以加載磁盤文件、TBitmap、TPngImage 等等適合靜態(tài)展示。不少人會偷懶直接在 TImage.Canvas 上畫二維碼我一開始也這么干過結(jié)果窗體一縮放、一遮擋TImage 上的內(nèi)容就被系統(tǒng)擦掉了因為它并不負責持久化繪制內(nèi)容。用 PaintBox 就清楚很多數(shù)據(jù)變了就調(diào)用 Invalidate 觸發(fā)重繪OnPaint 里統(tǒng)一處理邏輯上是閉環(huán)的。而 TImage 用來做最終結(jié)果展示和文件預覽分工干凈利落。2. 二維碼生成的底層邏輯先把矩陣搞清楚2.1 二維碼本質(zhì)上是一張位圖矩陣理解了底層再看代碼很多坑就能提前避開。QR Code 這個東西表面上是一張黑白相間的方塊圖實際上是一個行列固定的布爾矩陣黑色模塊代表 1白色模塊代表 0。這個矩陣里既有我們輸入的數(shù)據(jù)內(nèi)容也有定位圖形、校正圖形、時序圖形這些專門用于掃描定位的元素。所以二維碼生成庫的工作本質(zhì)就兩步一是把你的字符串編碼成符合 QR 規(guī)范的數(shù)據(jù)位流二是在內(nèi)存里拼出一個 rows * columns 的二維布爾數(shù)組。繪制環(huán)節(jié)完全不需要關心里面的編碼細節(jié)只需要拿著這個布爾數(shù)組把每個為 true 的格子畫成一個帶顏色的矩形就得到了肉眼可見的二維碼。這也是為什么 PaintBox 很適合做這件事它的 Canvas 畫矩形是基本操作。2.2 生成器在中間做了四件事如果你用封裝好的庫這些事都是透明的但知道一下沒有壞處至少調(diào)試的時候不會瞎猜。第一件事是數(shù)據(jù)分析檢查待編碼內(nèi)容屬于純數(shù)字、字母數(shù)字、字節(jié)還是漢字模式選擇最緊湊的編碼方式。第二件事是數(shù)據(jù)編碼把內(nèi)容變成比特流加入模式指示符、字符計數(shù)符和終止符。第三件事是生成糾錯碼這里用的是 Reed-Solomon 算法把原始數(shù)據(jù)按照設定的糾錯級別拆塊每塊生成糾錯碼這樣二維碼局部被遮擋或污損時依然能解出來。第四件事是把數(shù)據(jù)碼和糾錯碼按規(guī)則填入矩陣再執(zhí)行掩碼運算并寫入版本信息和格式信息。掩碼這一步可能很多人不知道它的目的不是加密而是讓生成出來的二維碼黑色模塊分布盡量均勻避免出現(xiàn)大面積的空白或密集方塊導致掃描器無法定位。整個過程標準文檔寫了幾十頁但你完全不需要自己實現(xiàn)開源社區(qū)早就把這塊固化成穩(wěn)定的庫了。2.3 版本、糾錯級別和參數(shù)選擇二維碼版本從 1 到 40版本越高矩陣越大容量越大。V1 是 21x21 的模塊每增加一個版本矩陣一邊增加 4 個模塊到 V40 是 177x177。同一個版本下容量還受糾錯級別影響。糾錯級別分 L、M、Q、H分別能容忍約 7%、15%、25%、30% 的碼字損壞。級別越高能存的有效內(nèi)容越少但抗污損能力越強。我的經(jīng)驗是普通業(yè)務場景選 M 級別就夠內(nèi)容比較短的比如鏈接、編號直接用 H 也不會虧。但是要注意內(nèi)容長度決定版本號版本越高矩陣越大如果顯示尺寸固定高版本的每個模塊像素就越小掃碼設備識別難度會上升。所以不要盲目追求大容量能短則短。另外還有一個參數(shù)容易被忽略就是靜區(qū)也就是二維碼周圍一圈空白的寬度。規(guī)范要求至少 4 個模塊寬實際測試下來少于這個值手機還能掃但工業(yè)掃碼槍很容易翻車。這個參數(shù)后面繪制和保存時會反復用到。3. 核心實現(xiàn)PaintBox 上把二維碼畫出來3.1 生成庫的選型和引入Delphi 生態(tài)里現(xiàn)成的二維碼生成方案不算多但有一款基于 ZXing 移植的開源庫相當能打純 Delphi 實現(xiàn)沒有第三方動態(tài)庫依賴可以在舊版本的 Delphi 里直接用。市面上還有 Delphi XE 自帶的某些組件以及各種個人封裝的單元但對比下來ZXing 移植版勝在編碼規(guī)范、支持多版本多糾錯級別、矩陣輸出接口清晰非常適合我們把繪制邏輯自己做一遍。引入方式很簡單下載源碼后把相關單元所在目錄加入 Project Manager 里的 Search Path 就行然后在你自己的單元 uses 里加上聲明。整個過程不裝包、不注冊組件和寫普通代碼完全一樣。我建議不要用那種直接把整張二維碼圖片生成好的重量級封裝因為項目里后續(xù)需求往往會有變動比如加 Logo、改靜區(qū)尺寸、只生成矩陣自己排版打印矩陣輸出的接口比圖片輸出接口好用得多。3.2 從字符串到矩陣再到 Canvas核心代碼看下面這段。首先生成器對象設置 Data 為要編碼的內(nèi)容Encoding 用字節(jié)模式這樣中文和特殊字符都能按 UTF-8 正確處理。QuietZone 設置為 4對應靜區(qū) 4 個模塊。ErrorCorrectionLevel 這里設成 1表示 M 級糾錯。隨后遍歷矩陣所有 IsBlack 為 true 的格子都畫成黑色矩形。type TFormQRCode class(TForm) PaintBox1: TPaintBox; btnGenerate: TButton; procedure btnGenerateClick(Sender: TObject); procedure FormCreate(Sender: TObject); private QRCore: TDelphiZXingQRCode; public procedure DrawMatrix(PBox: TPaintBox); end; implementation procedure TFormQRCode.FormCreate(Sender: TObject); begin QRCore : TDelphiZXingQRCode.Create; end; procedure TFormQRCode.btnGenerateClick(Sender: TObject); begin QRCore.Data : edtContent.Text; QRCore.Encoding : TQRCodeEncoding.qrEncodingByte; QRCore.QuietZone : 4; QRCore.ErrorCorrectionLevel : 1; PaintBox1.Invalidate; end; procedure TFormQRCode.DrawMatrix(PBox: TPaintBox); var Row, Col: Integer; ModuleSize, Margin: Integer; DrawWidth, DrawHeight: Integer; X, Y: Integer; begin ModuleSize : 8; Margin : ModuleSize * QRCore.QuietZone; DrawWidth : QRCore.Columns * ModuleSize Margin * 2; DrawHeight : QRCore.Rows * ModuleSize Margin * 2; PBox.Canvas.Brush.Color : clWhite; PBox.Canvas.FillRect(Rect(0, 0, DrawWidth, DrawHeight)); PBox.Canvas.Brush.Color : clBlack; for Row : 0 to QRCore.Rows - 1 do begin for Col : 0 to QRCore.Columns - 1 do begin if QRCore.IsBlack[Row, Col] then begin X : Margin Col * ModuleSize; Y : Margin Row * ModuleSize; PBox.Canvas.FillRect(Rect(X, Y, X ModuleSize, Y ModuleSize)); end; end; end; PBox.Width : DrawWidth; PBox.Height : DrawHeight; end;這段代碼里最關鍵的一個點就是繪制尺寸的計算。很多人直接把 PaintBox 撐滿整個窗體然后從左上角開始畫結(jié)果二維碼擠在角落靜區(qū)也沒有掃起來特別費勁。正確的做法是先根據(jù)矩陣列數(shù)和模塊尺寸算出總寬度再把整個繪制邏輯和 PaintBox 的寬高綁定。這樣無論內(nèi)容長短、版本高低二維碼都能居中占滿控件且四周留有標準的白邊。3.3 繪制參數(shù)調(diào)試模塊尺寸與靜區(qū)模塊尺寸選多大取決于二維碼最終要在哪看。如果只是在屏幕上展示模塊尺寸 6 到 8 像素很合適畫面干凈。如果還要打印到小標簽上那模塊尺寸建議按打印分辨率換算通常至少 4 個打印像素。模塊尺寸過小的直接后果是模塊與模塊之間幾乎沒有間隔黑白邊緣容易被打印機糊成一團。靜區(qū)在上面的代碼里由 QRCore.QuietZone 參數(shù)控制我固定設為 4。這里要提醒一點如果你自己實現(xiàn)繪制不要只在矩陣外邊留幾個像素就算靜區(qū)必須按模塊尺寸乘以靜區(qū)模塊數(shù)來計算。還有顏色選擇我堅持用純黑和純白不要為了 UI 美觀把前景改成深藍、深綠很多掃碼引擎對非標準黑色邊緣的容錯很差尤其是低端掃碼槍。如果想要“彩色二維碼”的效果更穩(wěn)妥的做法是先保存黑白底圖再通過位圖后處理給白色區(qū)域染色黑色模塊保持不動。4. 保存本地文件并加載到 Image 控件4.1 為什么要繞一層文件操作有朋友問既然已經(jīng)畫在 PaintBox 上了直接 Image1.Picture.Assign(PaintBox1.Canvas) 這種思路行不行答案是不行Canva 不是圖形對象不能直接賦值給 Picture。另外標題里的需求本來就要求“保存為本地文件并添加至 Image 控件中”這個文件是要拿來歸檔、打印、上傳服務端的不是臨時展示用。所以正確的鏈路是PaintBox 繪制完成后把它 Canvas 上的內(nèi)容拷貝到一個 TBitmap再由 TBitmap 轉(zhuǎn)成 TPngImage 保存成磁盤文件。保存完之后Image 控件再從磁盤加載這個 PNG。這樣文件有了展示也有了后面想對這個文件做二次處理比如加水印、壓縮、合并都有明確的操作對象。4.2 保存為 PNG 的具體實現(xiàn)下面的代碼把 PaintBox 的內(nèi)容拷貝到一個 24 位色的 Bitmap然后轉(zhuǎn)成 PNG 保存。注意拷貝之前一定要確保 PaintBox 已經(jīng)完成了一次完整的重繪否則 Canvas 上可能是舊數(shù)據(jù)或者空白。我習慣在生成函數(shù)里顯式調(diào)用一下 PaintBox1.Update()強制刷新整個窗口消息隊列確保畫布內(nèi)容落定。uses System.SysUtils, System.Classes, Vcl.Graphics, Vcl.Controls, Vcl.Forms, Vcl.ExtCtrls, Vcl.Imaging.pngimage; procedure SavePaintBoxToPng(PBox: TPaintBox; const AFileName: string); var Bmp: TBitmap; Png: TPngImage; W, H: Integer; begin W : PBox.Width; H : PBox.Height; if (W 0) or (H 0) then Exit; Bmp : TBitmap.Create; try Bmp.Width : W; Bmp.Height : H; Bmp.PixelFormat : pf24bit; Bmp.Canvas.Brush.Color : clWhite; Bmp.Canvas.FillRect(Rect(0, 0, W, H)); Bmp.Canvas.CopyRect( Rect(0, 0, W, H), PBox.Canvas, PBox.ClientRect); Png : TPngImage.Create; try Png.Assign(Bmp); Png.SaveToFile(AFileName); finally Png.Free; end; finally Bmp.Free; end; end;為什么不直接存 BMP 而轉(zhuǎn)成 PNG因為 PNG 是無損壓縮白底黑字的二維碼壓縮率極高存出來可能只有幾 KB而 BMP 一張 300x300 的圖就有二百多 KB。還有一點PNG 自帶 alpha 通道和像素格式信息后續(xù)如果用其他平臺處理兼容性比 BMP 好太多。JPG 格式我是強烈不建議用的JPG 是有損壓縮黑色模塊邊緣會出現(xiàn)顏色擴散和模糊一旦模塊較小掃碼識別率斷崖式下降后面講踩坑會細說。4.3 Image 控件顯示參數(shù)設置與優(yōu)化文件保存好之后加載進 Image 很簡單一行代碼Image1.Picture.LoadFromFile(AFileName);但這里有個新手高頻問題加載進去之后顯示只露出左上角一小塊二維碼其他部分都是空白。原因很簡單TImage 控件的 Stretch 屬性默認是 FalsePicture 多大它就按原始像素尺寸顯示如果控件比圖片小內(nèi)容就會被裁剪。解決辦法是把 Stretch 設為 TrueProportional 設為 TrueAutoSize 保持 False。Stretch True圖片自動縮放填滿控件區(qū)域。Proportional True縮放時保持寬高比不會把二維碼壓扁。Center True縮放后如果還有留白讓圖片居中。這三個屬性配合起來不管 Image 控件在窗體里被拉大還是縮小二維碼始終保持正方形且居中顯示。如果你想把二維碼放大預覽按鈕里動態(tài)設置 Image1.Width 和 Height 就行不需要重新生成文件。5. 我踩過的坑與排查速查5.1 繪制閃爍問題第一次把繪制代碼塞進 OnPaint 之后每次鼠標劃過窗體二維碼區(qū)域就瘋狂閃爍。原因是 PaintBox 背景先被清成白色再畫黑色模塊重繪頻率高的時候人眼就能捕捉到閃爍。解決方案有兩個一是 Form 的 DoubleBuffered 屬性設為 True讓 VCL 在內(nèi)存畫布上完成整套繪制后再一次性復制到屏幕二是減少不必要的重繪只有數(shù)據(jù)改變或控件尺寸改變時才調(diào)用 Invalidate。最穩(wěn)的做法是把繪制邏輯封裝成一個獨立函數(shù)按鈕點擊時設置矩陣數(shù)據(jù)、計算新尺寸最后才 Invalidate。不要在 OnPaint 里去讀取 Edit 框內(nèi)容、去請求網(wǎng)絡、去做 IO 操作。VCL 的繪制事件頻率遠比你想象的高窗口遮擋恢復、窗體拖動、最小化還原都會觸發(fā)干重活會導致界面明顯卡頓。還有一個小技巧如果某個界面里二維碼和其他控件布局比較復雜可以把 PaintBox 的 Enabled 設為 False。這樣它不響應鼠標交互從根本上減少無意義的刷新。5.2 DPI 縮放導致的鋸齒和虛化高 DPI 屏幕上VCL 窗體如果啟用了縮放控件會被整體放大。這時 PaintBox 的 Width、Height 是物理像素還是邏輯像素會直接影響繪制清晰度。我遇到過 150% 縮放下模塊邊緣出現(xiàn)灰邊、掃碼時識錯的情況原因是繪制時用了物理 Canvas但坐標計算基于邏輯尺寸黑色矩形被系統(tǒng)插值拉伸邊緣就虛了。解決思路是按當前 PixelsPerInch 動態(tài)調(diào)整 ModuleSize保證每個模塊的物理寬度是一個整數(shù)。簡單實現(xiàn)就是在繪制前讀取 Form 的 PixelsPerInch 和設計時基準值換算出實際模塊尺寸。另外保存文件的過程不受屏幕影響因為 Bitmap 尺寸完全由我們自己指定和屏幕分辨率無關。所以我建議屏幕展示圖稍虛沒關系保存出去的 PNG 一定要按固定邏輯尺寸生成保證掃描穩(wěn)定。5.3 保存出來的圖片掃不出來這個坑最隱蔽曾經(jīng)讓我排查了一個下午?，F(xiàn)象是 PaintBox 上掃碼正常保存成 PNG 后手機能掃但工業(yè)掃碼槍怎么都掃不到。后面對比兩張圖發(fā)現(xiàn)PaintBox 上顯示時周圍有空白的窗體背景實際上發(fā)揮了靜區(qū)作用而保存出來的 PNG 因為繪制時 Margin 設置為 0黑白矩陣貼邊生成掃碼槍讀不了。處理辦法就是本文前面反復提到的靜區(qū)參數(shù)QuietZone 至少 4保存時最外層 4 圈模塊寬度必須是空白。另外一個導致掃不出來的原因是保存尺寸太小如果二維碼是 V10 以上的版本模塊數(shù)量多但你把圖片整體壓到 100x100 像素那每個模塊平均只有不到 3 像素很多掃碼引擎直接放棄。我通常保證最終保存的圖片邊長不低于 400 像素模塊尺寸不小于 6 像素。5.4 二次加載與文件占用問題有業(yè)務需求是保存后立即把文件刪掉只讓圖片保留在 Image 控件里。實際操作時發(fā)現(xiàn)LoadFromFile 之后立刻 DeleteFile 會失敗有一部分原因是殺毒軟件還在掃描文件另一部分是 Image 控件內(nèi)部還沒有完全釋放文件句柄。穩(wěn)妥做法是先用 Try 包裝刪除確認延遲幾百毫秒如果真的必須馬上刪可以先把 Picture 保存到內(nèi)存里的 TBitmap再加載到 Image之后刪除文件就毫無障礙。另外一個相關問題是PaintBox 繪制的二維碼在窗體最小化再恢復之后OnPaint 觸發(fā)時會重新繪制這個前提下代碼里必須保證矩陣對象還在或者至少數(shù)據(jù)源還在。我見過有人直接把循環(huán)畫在 FormCreate 里結(jié)果窗口一刷新二維碼就消失了。正確做法是把矩陣生成結(jié)果緩存成一個字段OnPaint 只做繪制。5.5 常見問題速查表問題現(xiàn)象可能原因解決辦法二維碼繪制區(qū)域閃爍PaintBox 頻繁重繪未開雙緩沖Form.DoubleBuffered : True數(shù)據(jù)變化再 Invalidate高 DPI 下邊緣虛化邏輯尺寸與物理像素不匹配動態(tài)調(diào)整 ModuleSize用整數(shù)像素繪制保存后掃碼槍識別失敗靜區(qū)不足或模塊太小QuietZone 設為 4圖片邊長不低于 400 像素JPG 保存后無法掃描有損壓縮導致模塊邊緣模糊改用 PNG 保存Image 控件只顯示一角Stretch 為 False設置 Stretch / Proportional / Center 為 True窗體恢復后二維碼消失繪制邏輯不在 OnPaint 里緩存矩陣在 OnPaint 中統(tǒng)一繪制DeleteFile 刪除失敗圖片文件句柄未釋放加載到內(nèi)存后再刪除或延遲刪除內(nèi)容包含中文掃出來亂碼編碼模式或字符集不一致Encoding 使用字節(jié)模式UTF-8掃碼端約定一致6. 擴展從“能掃出來”到“掃得快、不翻車”6.1 給二維碼加 Logo 的注意事項很多客戶會要求在二維碼中間放一個企業(yè) Logo外觀上確實更有辨識度。實現(xiàn)上并不復雜在生成好的 Bitmap 正中央把 Logo 圖片按比例縮小后繪制上去。但核心問題是Logo 區(qū)域會遮擋一部分矩陣模塊QR 碼的 Reed-Solomon 糾錯能力能扛住一定程度的遮擋H 級別最高可以容忍約 30% 的碼字損壞。所以加 Logo 時必須把糾錯級別提升到 H設置 ErrorCorrectionLevel 為 3。Logo 尺寸建議不要超過二維碼邊長的四分之一也就是中心 1/4 區(qū)域內(nèi)的遮擋會被糾錯抵消。還有一個小細節(jié)Logo 圖案最好不要帶大面積的純黑或純白背景尤其是不能帶有與黑色模塊相似的規(guī)則紋理否則掃描器會誤判為數(shù)據(jù)模塊。我一般會把 Logo 周圍留一圈白邊再放到二維碼上。6.2 批量生成與文件命名策略如果業(yè)務上要一次生成幾十上百個二維碼循環(huán)調(diào)用生成庫即可每個二維碼生成計算量很小不需要額外開線程。但文件命名和日志管理值得提前規(guī)劃。我習慣用“前綴 日期 業(yè)務ID 隨機短碼”的方式比如 DEV20250615-0001-X7K3.png這樣歸檔時按前綴分類、按日期檢索、按業(yè)務ID關聯(lián)非常清晰。批量場景還有一個常見需求是連同二維碼一起導出 Excel 或 SQLite 記錄表生成后把文件名、內(nèi)容、生成時間、版本、糾錯級別一并記錄。千萬不要在文件名里放中文和特殊符號有些共享目錄和打印系統(tǒng)的編碼處理很弱極易出錯。文件名里的信息越少越穩(wěn)真正的內(nèi)容全部放在關聯(lián)表里。6.3 二維碼內(nèi)容協(xié)議與數(shù)據(jù)安全二維碼能承載的內(nèi)容有限但很多人會往里塞一長串 JSON結(jié)果版本飆到 V20 以上掃碼變慢打印變小純屬自找麻煩。我建議在系統(tǒng)設計階段就約定一個緊湊的內(nèi)容協(xié)議比如DEV|SN20250615|A1B2C3這種管道符分隔格式掃描端按固定順序拆分即可。如果是 URL就盡量用短鏈接服務或者干脆放一個跳轉(zhuǎn)參數(shù)別把完整參數(shù)往二維碼里塞。涉及敏感信息時直接在二維碼里放明文不可取。二維碼本身沒有任何加密能力貼在產(chǎn)品標簽上誰都能掃。要保護的內(nèi)容先做加密再編碼例如用 AES 加密后轉(zhuǎn) Base64掃描端再反向解密。如果項目允許離線驗簽可以在內(nèi)容尾部加一段 HMAC 簽名掃碼后校驗簽名確認數(shù)據(jù)未被篡改。這些內(nèi)容看起來超出“畫二維碼”的范疇但實際項目里往往和二維碼功能綁定出現(xiàn)提前設計能省掉后面改協(xié)議的痛苦。我自己在實際項目里踩得最慘的一次就是把二維碼當成普通圖片處理最后因為格式和靜區(qū)問題耽誤了上線。以后的習慣是內(nèi)容先定協(xié)議生成用矩陣接口繪制時算好模塊尺寸和靜區(qū)保存永遠走 PNG顯示用 Image 的三件套屬性。這套流程順下來不管是畫在 PaintBox、保存到本地文件、加載到 Image 控件還是后續(xù)加 Logo、批量導出、加密簽名都只是在這個骨架上加東西而已。