簡(jiǎn)介基于C#的倉(cāng)庫(kù)條碼管理系統(tǒng)源碼是一套面向計(jì)算機(jī)專(zhuān)業(yè)畢業(yè)設(shè)計(jì)的完整項(xiàng)目。系統(tǒng)以.NET Framework為開(kāi)發(fā)平臺(tái)采用Windows Forms構(gòu)建操作界面圍繞入庫(kù)、出庫(kù)、庫(kù)存查詢(xún)、條碼掃描與報(bào)表生成等核心業(yè)務(wù)展開(kāi)適合希望從實(shí)際項(xiàng)目入手學(xué)習(xí)C#數(shù)據(jù)訪問(wèn)、第三方條碼解析與數(shù)據(jù)庫(kù)設(shè)計(jì)的開(kāi)發(fā)者。資源共132個(gè)文件壓縮包約9.96MB包含47個(gè)cs源碼文件、20個(gè)resx界面資源、19個(gè)resources資源文件、18張jpg圖片素材同時(shí)附帶SQL腳本、MDF/LDF數(shù)據(jù)庫(kù)文件、解決方案文件、配置文件和可執(zhí)行程序目錄結(jié)構(gòu)清晰便于按模塊閱讀和二次開(kāi)發(fā)。目前已有204人學(xué)習(xí)下載。借助該源碼可快速掌握條碼掃描、ZXing.NET集成、ADO.NET或Entity Framework數(shù)據(jù)操作、報(bào)表分析與庫(kù)存預(yù)警等功能是一個(gè)可直接運(yùn)行并用于畢業(yè)設(shè)計(jì)答辯的實(shí)用參考項(xiàng)目。1. 倉(cāng)庫(kù)條碼管理系統(tǒng)用 C# 做這件事核心不只是掃碼倉(cāng)庫(kù)條碼管理系統(tǒng)WMS 的輕量形態(tài)在 C# 技術(shù)棧里是出現(xiàn)頻率極高的項(xiàng)目類(lèi)型。無(wú)論是畢業(yè)設(shè)計(jì)、企業(yè)內(nèi)部工具還是小團(tuán)隊(duì)的第一版?zhèn)}儲(chǔ)系統(tǒng)都會(huì)選擇 C# 數(shù)據(jù)庫(kù) 條碼掃描槍的組合。原因很直接C# 對(duì)串口、USB 掃碼設(shè)備和 Windows 環(huán)境的支持非常成熟WinForms/WPF 做桌面客戶(hù)端上手快加上 Entity Framework 或原生 ADO.NET 操作 SQL Server/SQLite 都足夠穩(wěn)。這套系統(tǒng)的本質(zhì)不是“掃碼”本身而是把掃碼事件轉(zhuǎn)換為庫(kù)存事務(wù)入庫(kù)單掃描托盤(pán)條碼累加庫(kù)存出庫(kù)單掃描物料條碼扣減庫(kù)存盤(pán)點(diǎn)單掃描實(shí)物條碼與賬面數(shù)比對(duì)。條碼在這里只是“數(shù)據(jù)的鑰匙”真正值錢(qián)的是掃描背后的庫(kù)存邏輯、單據(jù)狀態(tài)流轉(zhuǎn)和錯(cuò)誤處理。適合誰(shuí)做有 C# 基礎(chǔ)、想完整走一遍從數(shù)據(jù)庫(kù)設(shè)計(jì)到業(yè)務(wù)落地的開(kāi)發(fā)者或者倉(cāng)庫(kù)管理崗位想用輕量工具替代 Excel 出入庫(kù)記錄的從業(yè)者。2. 架構(gòu)選型WinForms 還是 WPF數(shù)據(jù)庫(kù)和掃碼方式怎么定2.1 客戶(hù)端框架WinForms 夠用WPF 適合需要復(fù)雜界面的場(chǎng)景倉(cāng)庫(kù)條碼管理系統(tǒng)的客戶(hù)端框架我在實(shí)際項(xiàng)目中兩種都用過(guò)。純內(nèi)部工具、操作員文化程度參差不齊、界面只需要表格和按鈕WinForms 的 DataGridView 綁定數(shù)據(jù)源后分分鐘出活部署也簡(jiǎn)單——.NET Framework 4.7.2 在 Windows 10/11 上基本不需要額外裝運(yùn)行時(shí)。但如果要做庫(kù)位可視化、掃描動(dòng)效反饋、多標(biāo)簽頁(yè)復(fù)雜交互WPF 的 MVVM 模式和數(shù)據(jù)綁定會(huì)讓后續(xù)維護(hù)輕松很多。我一般會(huì)建議如果你是第一次做這個(gè)系統(tǒng)或者團(tuán)隊(duì)里 C# 水平參差不齊選 WinForms。原因不是 WPF 不好而是倉(cāng)庫(kù)現(xiàn)場(chǎng)的電腦配置普遍不高WinForms 對(duì)低配工控機(jī)的兼容性更好而且 WinForms 的 DataGridView 做入庫(kù)明細(xì)錄入比 WPF 的 DataGrid 少很多樣式坑。如果你要對(duì)接多個(gè)屏幕展示庫(kù)存看板、做深色主題、需要流暢的動(dòng)畫(huà)提醒才值得上 WPF。// WinForms 主窗體初始化 public partial class MainForm : Form { private readonly string _connString Data Sourcewarehouse.db;Version3;; private DataGridView _dgvStock; private TextBox _txtScanInput; public MainForm() { InitializeComponent(); InitScanInput(); LoadStockData(); } private void InitScanInput() { _txtScanInput new TextBox(); _txtScanInput.KeyDown TxtScanInput_KeyDown; } }這段代碼里做了兩件事設(shè)置 SQLite 連接字符串以及初始化掃碼輸入框。注意掃碼輸入框的實(shí)現(xiàn)思路——多數(shù) USB 掃碼槍模擬鍵盤(pán)輸入掃碼后自動(dòng)輸入條碼內(nèi)容并觸發(fā)回車(chē)鍵所以 KeyDown 事件就是處理掃碼的核心入口。連接字符串里的Version3是 SQLite 的版本號(hào)不能漏掉。2.2 數(shù)據(jù)庫(kù)選型單機(jī)用 SQLite多客戶(hù)端用 SQL Server Express倉(cāng)庫(kù)條碼管理系統(tǒng)的數(shù)據(jù)量其實(shí)不大一張出庫(kù)單幾十條明細(xì)一年下來(lái)也就幾十萬(wàn)行。SQLite 單文件數(shù)據(jù)庫(kù)在單機(jī)場(chǎng)景下完全夠用而且備份就是復(fù)制一個(gè)文件方便到離譜。但要注意SQLite 不支持多進(jìn)程并發(fā)寫(xiě)入如果有兩臺(tái)以上的電腦同時(shí)對(duì)同一個(gè)庫(kù)文件做寫(xiě)入操作需要考慮用 SQL Server Express免費(fèi)版或者把應(yīng)用改成服務(wù)端架構(gòu)。多客戶(hù)端場(chǎng)景我踩過(guò)坑——SQLite 在 Windows 共享文件夾上被兩個(gè)客戶(hù)端同時(shí)打開(kāi)就會(huì)出現(xiàn)database is locked錯(cuò)誤。所以選型邏輯應(yīng)該是只有一臺(tái)電腦操作倉(cāng)庫(kù)直接用 SQLite超過(guò)兩個(gè)操作端直接上 SQL Server Express免費(fèi)版已經(jīng)支持 10GB 數(shù)據(jù)庫(kù)小倉(cāng)庫(kù)綽綽有余。-- 核心表結(jié)構(gòu)物料表 CREATE TABLE Material ( Id INTEGER PRIMARY KEY AUTOINCREMENT, MaterialCode TEXT NOT NULL UNIQUE, -- 物料編碼 MaterialName TEXT NOT NULL, -- 物料名稱(chēng) Spec TEXT, -- 規(guī)格型號(hào) Unit TEXT, -- 計(jì)量單位 SafetyStock REAL DEFAULT 0 -- 安全庫(kù)存 );物料編碼必須設(shè)置唯一約束這是條碼管理的基石。倉(cāng)庫(kù)條碼系統(tǒng)最怕一碼多物如果物料表里出現(xiàn)兩條相同的編碼掃碼入庫(kù)時(shí)系統(tǒng)無(wú)法判斷該累加到哪一條后面所有庫(kù)存數(shù)據(jù)都是錯(cuò)的。安全庫(kù)存字段雖然是默認(rèn) 0但建議從一開(kāi)始就維護(hù)上后面做庫(kù)存預(yù)警直接查詢(xún)這個(gè)字段就行不用再改表結(jié)構(gòu)。2.3 條碼生成與識(shí)別ZXing 庫(kù)是主流選擇C# 生態(tài)里條碼生成和識(shí)別的庫(kù)最常用的是 ZXing.Net。它支持 Code 128、EAN-13、QR Code 等多種碼制倉(cāng)庫(kù)場(chǎng)景首推 Code 128——它支持全部 ASCII 字符密度高掃描槍識(shí)別速度快而且條碼長(zhǎng)度沒(méi)有硬性限制。相比之下 EAN-13 只能編碼數(shù)字且必須 13 位限制太多。QR Code 雖然能存更多信息但倉(cāng)庫(kù)掃碼槍對(duì) QR 的識(shí)別速度不如 Code 128而且二維碼被油污遮擋后整張報(bào)廢一維碼還能靠部分識(shí)別挽救。using ZXing; using ZXing.Common; using ZXing.Rendering; public static class BarcodeHelper { public static Bitmap GenerateCode128(string content, int width 400, int height 120) { var writer new BarcodeWriterBitmap { Format BarcodeFormat.CODE_128, Options new EncodingOptions { Width width, Height height, Margin 10, PureBarcode false }, Renderer new BitmapRenderer() }; return writer.Write(content); } }段落說(shuō)明生成條碼時(shí)注意PureBarcode false表示條碼下方顯示人類(lèi)可讀的文本內(nèi)容。我習(xí)慣把物料編碼連同物料名稱(chēng)一起打印在條碼標(biāo)簽上這樣現(xiàn)場(chǎng)操作員即使掃碼槍壞了也能人工核對(duì)。條碼內(nèi)容建議只用物料編碼不要混入日期、批次等動(dòng)態(tài)信息——一碼一物是原則把批次寫(xiě)進(jìn)條碼會(huì)讓標(biāo)簽種類(lèi)爆炸式增長(zhǎng)。寬度和高度參數(shù)根據(jù)實(shí)際標(biāo)簽紙尺寸調(diào)整一般 50mm 寬的標(biāo)簽紙對(duì)應(yīng) 400x120 像素足夠。3. 核心功能落地入庫(kù)、出庫(kù)、盤(pán)點(diǎn)三條主線的實(shí)現(xiàn)細(xì)節(jié)3.1 數(shù)據(jù)庫(kù)設(shè)計(jì)一次把表建對(duì)后面少改三個(gè)月倉(cāng)庫(kù)條碼管理系統(tǒng)的數(shù)據(jù)庫(kù)設(shè)計(jì)核心是五張表Material物料、Stock庫(kù)存、StockInOrder入庫(kù)單、StockOutOrder出庫(kù)單、StockOrderDetail單據(jù)明細(xì)。庫(kù)存表不要只存總量要拆到“庫(kù)位 物料”維度否則以后想做先進(jìn)先出或者庫(kù)位管理時(shí)數(shù)據(jù)沒(méi)法回溯。CREATE TABLE Stock ( Id INTEGER PRIMARY KEY AUTOINCREMENT, MaterialCode TEXT NOT NULL, LocationCode TEXT NOT NULL, -- 庫(kù)位編碼 Quantity REAL NOT NULL DEFAULT 0, LastUpdateTime TEXT NOT NULL, UNIQUE(MaterialCode, LocationCode) ); CREATE TABLE StockInOrder ( Id INTEGER PRIMARY KEY AUTOINCREMENT, OrderNo TEXT NOT NULL UNIQUE, -- 入庫(kù)單號(hào) Supplier TEXT, Operator TEXT NOT NULL, CreateTime TEXT NOT NULL, Status INTEGER NOT NULL DEFAULT 0 -- 0草稿, 1已入庫(kù) );設(shè)計(jì)要點(diǎn)是庫(kù)存表用UNIQUE(MaterialCode, LocationCode)做聯(lián)合唯一約束同一個(gè)物料在同一個(gè)庫(kù)位只能有一條記錄。入庫(kù)時(shí)先查是否存在——存在就 UPDATE 累加不存在就 INSERT 新記錄。這個(gè)邏輯用一條 UPSERT 語(yǔ)句可以搞定但為了代碼可讀性和后續(xù)加日志我更傾向于先查后更新的方式。單據(jù)狀態(tài)字段Status必須保留草稿狀態(tài)可以讓操作員掃描時(shí)掃錯(cuò)碼后刪除重掃已入庫(kù)狀態(tài)則不允許修改只能紅沖。3.2 入庫(kù)操作掃描槍觸發(fā)事件與庫(kù)存事務(wù)寫(xiě)入入庫(kù)操作是操作員在入庫(kù)單界面用掃描槍掃物料條碼系統(tǒng)自動(dòng)在明細(xì)列表里累加數(shù)量。整個(gè)流程的核心不在界面而在事件處理和事務(wù)控制。掃碼槍模擬鍵盤(pán)輸入的模式下KeyDown事件捕獲回車(chē)鍵后先校驗(yàn)條碼是否存在再更新界面上的明細(xì)列表最后點(diǎn)擊“確認(rèn)入庫(kù)”時(shí)一次性把全部明細(xì)寫(xiě)入數(shù)據(jù)庫(kù)。private void TxtScanInput_KeyDown(object sender, KeyEventArgs e) { if (e.KeyCode Keys.Enter) { e.SuppressKeyPress true; // 阻止回車(chē)鍵在界面上觸發(fā)別的事件 string barcode _txtScanInput.Text.Trim(); if (string.IsNullOrEmpty(barcode)) return; ProcessScan(barcode); _txtScanInput.Clear(); } } private void ProcessScan(string barcode) { // 查詢(xún)物料表判斷條碼是否有效 using (var conn new SQLiteConnection(_connString)) { conn.Open(); string sql SELECT MaterialCode, MaterialName FROM Material WHERE MaterialCode code; using (var cmd new SQLiteCommand(sql, conn)) { cmd.Parameters.AddWithValue(code, barcode); using (var reader cmd.ExecuteReader()) { if (reader.Read()) { // 更新界面 DataGridView把掃描到的物料加到待入庫(kù)列表 AddToInOrderGrid(reader[MaterialCode].ToString(), reader[MaterialName].ToString()); } else { MessageBox.Show($條碼 【{barcode}】 在物料表中不存在, 掃描錯(cuò)誤); } } } } }這里的e.SuppressKeyPress true非常關(guān)鍵不寫(xiě)的話回車(chē)鍵會(huì)被 TextBox 當(dāng)成換行符或者觸發(fā)焦點(diǎn)跳轉(zhuǎn)導(dǎo)致掃描內(nèi)容被截?cái)?。掃碼槍的輸入速度極快一次掃描可能在幾十毫秒內(nèi)輸出全部字符用 TextBox 接收時(shí)如果處理不當(dāng)會(huì)丟字符——我一般會(huì)在KeyDown里判斷不在KeyPress事件里做業(yè)務(wù)邏輯。如果遇到掃描槍輸入丟字符的玄學(xué)問(wèn)題可以先接一個(gè)純文本框測(cè)試掃碼槍輸出是否完整再考慮代碼問(wèn)題。3.3 出庫(kù)扣減事務(wù)與并發(fā)控制的正確寫(xiě)法出庫(kù)是扣庫(kù)存比入庫(kù)敏感得多。如果操作員按下“確認(rèn)出庫(kù)”的同時(shí)另一臺(tái)電腦在做盤(pán)點(diǎn)調(diào)整庫(kù)存就可能被扣成負(fù)數(shù)或者出現(xiàn)臟讀。C# 里用 ADO.NET 的Transaction對(duì)象能把多步操作包成一個(gè)原子操作要么全部成功要么全部回滾這是出庫(kù)功能的地基。using (var conn new SQLiteConnection(_connString)) { conn.Open(); using (var tx conn.BeginTransaction()) { try { foreach (var detail in _outOrderDetails) { string sql UPDATE Stock SET Quantity Quantity - qty WHERE MaterialCode code AND LocationCode loc; using (var cmd new SQLiteCommand(sql, conn, tx)) { cmd.Parameters.AddWithValue(qty, detail.Quantity); cmd.Parameters.AddWithValue(code, detail.MaterialCode); cmd.Parameters.AddWithValue(loc, detail.LocationCode); int rows cmd.ExecuteNonQuery(); if (rows 0) { throw new Exception($庫(kù)存不足或庫(kù)位不存在: {detail.MaterialCode}); } } } tx.Commit(); } catch (Exception ex) { tx.Rollback(); MessageBox.Show($出庫(kù)失敗已回滾: {ex.Message}); } } }這段邏輯的精髓是ExecuteNonQuery返回影響行數(shù)UPDATE 影響 0 行代表庫(kù)存記錄不存在也就沒(méi)必要繼續(xù)扣減了直接拋異常讓整個(gè)事務(wù)回滾。注意這里不能只靠 SELECT 先查庫(kù)存再?zèng)Q定是否 UPDATE因?yàn)閮蓷l連接可能同時(shí)讀到同一份庫(kù)存并發(fā)下會(huì)超賣(mài)——直接執(zhí)行 UPDATE 并在 UPDATE 條件里加Quantity qty才是在數(shù)據(jù)庫(kù)層面保證原子性的正確做法可以把這段代碼看作是操作員點(diǎn)一次“確認(rèn)出庫(kù)”按鈕后系統(tǒng)從界面明細(xì)到數(shù)據(jù)庫(kù)事務(wù)的完整鏈路。-- 更安全的扣減SQL條件里帶上庫(kù)存充足判斷 UPDATE Stock SET Quantity Quantity - qty WHERE MaterialCode code AND LocationCode loc AND Quantity qty;如果影響行數(shù)為 0 且物料記錄存在說(shuō)明庫(kù)存不足。用這種方式替代先 SELECT 再 UPDATE 的流程可以避免并發(fā)下的超賣(mài)問(wèn)題。SQLite 在單寫(xiě)者模式下這招夠用SQL Server 下用同樣的 SQL 再加行鎖效果也成立。3.4 盤(pán)點(diǎn)單差異處理比數(shù)據(jù)采集更重要盤(pán)點(diǎn)功能容易做成一堆按鈕和表格實(shí)際上倉(cāng)庫(kù)盤(pán)點(diǎn)的核心是“復(fù)盤(pán)差異”。操作員用掃碼槍逐個(gè)掃描貨架上的物料系統(tǒng)記錄實(shí)盤(pán)數(shù)。掃完一批后與賬面數(shù)比對(duì)生成差異明細(xì)再讓操作員對(duì)差異條碼二次掃描確認(rèn)防止計(jì)數(shù)錯(cuò)誤導(dǎo)致虛盈虧。// 盤(pán)點(diǎn)差異計(jì)算 public class StocktakeResult { public string MaterialCode { get; set; } public decimal BookQuantity { get; set; } // 賬面數(shù)量 public decimal ActualQuantity { get; set; } // 實(shí)盤(pán)數(shù)量 public decimal Difference ActualQuantity - BookQuantity; } // 界面上的盤(pán)點(diǎn)差異列表按差異絕對(duì)值倒序 private void LoadStocktakeDiff() { string sql SELECT s.MaterialCode, s.Quantity AS BookQty, COALESCE(st.ActualQty, 0) AS ActQty FROM Stock s LEFT JOIN Stocktake st ON s.MaterialCode st.MaterialCode WHERE s.Quantity ! COALESCE(st.ActualQty, 0); // 綁定到 DataGridView按 |ActQty - BookQty| 降序 }盤(pán)點(diǎn)差異的確認(rèn)流程比代碼本身更重要差異超過(guò)一定比例比如 5%的物料建議單獨(dú)高亮并要求二次掃碼確認(rèn)避免操作員把條碼貼錯(cuò)位置導(dǎo)致盤(pán)點(diǎn)數(shù)據(jù)整體偏移。差異數(shù)據(jù)的持久化我在項(xiàng)目里是建一張單獨(dú)的表存儲(chǔ)每次盤(pán)點(diǎn)的快照方便后續(xù)追查歷史盈虧原因——這條思路雖然簡(jiǎn)單但實(shí)際執(zhí)行時(shí)往往被忽略導(dǎo)致倉(cāng)庫(kù)領(lǐng)導(dǎo)問(wèn)“這個(gè)月?lián)p耗到底出現(xiàn)在哪個(gè)環(huán)節(jié)”時(shí)拿不出數(shù)據(jù)。4. 條碼打印與標(biāo)簽?zāi)０瀣F(xiàn)場(chǎng)執(zhí)行力的最后一塊拼圖4.1 標(biāo)簽尺寸與打印方式選擇條碼標(biāo)簽打印是倉(cāng)庫(kù)條碼管理系統(tǒng)里最容易低估的環(huán)節(jié)。代碼寫(xiě)完、功能測(cè)試通過(guò)以為大功告成結(jié)果標(biāo)簽貼上貨架后掃描槍掃不出來(lái)。原因通常是標(biāo)簽尺寸和打印分辨率不匹配或者打印內(nèi)容過(guò)于密集。常見(jiàn)做法是用熱敏標(biāo)簽打印機(jī)斑馬、TSC 等品牌配合 30mm x 20mm 或 50mm x 30mm 的標(biāo)簽紙300dpi 分辨率足夠。標(biāo)簽內(nèi)容不必貪多——我在實(shí)際項(xiàng)目里見(jiàn)過(guò)一個(gè)標(biāo)簽上打印了物料編碼、名稱(chēng)、規(guī)格、批次、供應(yīng)商、日期、二維碼甚至價(jià)格結(jié)果一行字小到機(jī)器都認(rèn)不出來(lái)。一條經(jīng)驗(yàn)是標(biāo)簽只保留物料編碼大號(hào)字、物料名稱(chēng)中號(hào)字、一個(gè) Code 128 條碼這三樣是倉(cāng)庫(kù)掃碼識(shí)別的最基本組合。4.2 尺寸和字體在渲染層直接定死條碼字體大小和間距如果不加控制打印機(jī)的驅(qū)動(dòng)會(huì)按 96 DPI 的屏幕分辨率渲染到了打印機(jī)上就變形。常見(jiàn)做法是直接通過(guò) ZXing 生成 Bitmap 后用Graphics.DrawImage精確控制條碼和文字的位置不讓標(biāo)簽控件參與自動(dòng)縮放。using System.Drawing; using System.Drawing.Printing; public class LabelPrinter { public void PrintLabel(string materialCode, string materialName) { using (var doc new PrintDocument()) { doc.PrinterSettings.PrinterName ZDesigner GK420t; doc.DefaultPageSettings.PaperSize new PaperSize(Label, 400, 250); // 單位: 1/100英寸 doc.PrintPage (sender, e) { var barcode BarcodeHelper.GenerateCode128(materialCode, 360, 80); e.Graphics.DrawImage(barcode, 20, 10, 360, 80); using (var font new Font(Microsoft YaHei, 9, FontStyle.Regular)) { e.Graphics.DrawString(materialCode materialName, font, Brushes.Black, 20, 100); } }; doc.Print(); } } }打印這塊的坑主要集中在PaperSize的單位——它是 1/100 英寸不是像素。一個(gè) 50mm x 30mm 的標(biāo)簽換算成 PaperSize 是 50 / 25.4 * 100 ≈ 19730 / 25.4 * 100 ≈ 118。如果不換算直接塞像素值打印出來(lái)的標(biāo)簽會(huì)偏移或截?cái)?。另一個(gè)常見(jiàn)坑是打印隊(duì)列堵塞——標(biāo)簽打印機(jī)的驅(qū)動(dòng)默認(rèn)開(kāi)啟后臺(tái)打印如果前面有一張失敗的打印任務(wù)后面的任務(wù)會(huì)無(wú)限等待程序員以為是代碼問(wèn)題其實(shí)是 Windows 打印隊(duì)列里卡了廢棄任務(wù)清空隊(duì)列就能恢復(fù)。5. 避坑合集倉(cāng)庫(kù)條碼系統(tǒng)的 5 個(gè)高頻翻車(chē)點(diǎn)5.1 掃描槍輸入中文輸入法導(dǎo)致條碼帶字母丟失現(xiàn)象操作員在輸入單據(jù)號(hào)時(shí)切換了中文輸入法拼音掃描槍掃條碼后條碼里的英文字母和數(shù)字混在一起甚至直接變亂碼。原因多數(shù) USB 掃碼槍模擬鍵盤(pán)輸入掃描內(nèi)容按當(dāng)前輸入法狀態(tài)逐個(gè)鍵位注入。中文輸入法在全拼模式下會(huì)把字母鍵先攔截進(jìn)組詞緩沖區(qū)導(dǎo)致掃碼槍快速輸入的內(nèi)容被“吃掉”或順序錯(cuò)亂。解決全局強(qiáng)制英文輸入法。在 WinForms 主窗體加載時(shí)設(shè)置InputLanguage.CurrentInputLanguage InputLanguage.FromCulture(en-US)并禁止操作員切換。更穩(wěn)妥的方案是棄用鍵盤(pán)模擬模式買(mǎi)支持串口輸出RS232的掃描槍通過(guò)SerialPort接收條碼數(shù)據(jù)——串口模式不經(jīng)過(guò)鍵盤(pán)緩沖輸入法的影響為零。// 串口接收掃描槍數(shù)據(jù)示例 private SerialPort _sp; private void InitSerialPort(string portName, int baudRate 9600) { _sp new SerialPort(portName, baudRate, Parity.None, 8, StopBits.One); _sp.DataReceived Sp_DataReceived; _sp.Open(); } private void Sp_DataReceived(object sender, SerialDataReceivedEventArgs e) { string data _sp.ReadExisting(); // 條碼內(nèi)容通常在結(jié)尾有\(zhòng)r或\n按掃描槍手冊(cè)去掉結(jié)束符 string barcode data.TrimEnd(\r, \n); this.Invoke(new Action(() ProcessScan(barcode))); }串口方案的參數(shù)波特率一般掃描槍默認(rèn) 9600數(shù)據(jù)位 8、無(wú)校驗(yàn)、1 停止位是標(biāo)準(zhǔn)配置如果收不到數(shù)據(jù)先檢查串口號(hào)是否被占用這是上位機(jī)開(kāi)發(fā)的血淚經(jīng)驗(yàn)。5.2 DataGridView 綁定數(shù)據(jù)源后掃碼列表整頁(yè)刷新閃爍現(xiàn)象每掃一個(gè)條碼DataGridView 重新綁定 dataSource界面閃爍劇烈操作員在連續(xù)掃碼時(shí)眼睛受不了甚至誤以為程序崩潰。原因每次設(shè)置DataSource list都會(huì)讓 DataGridView 重建所有行焦點(diǎn)丟失、滾動(dòng)位置重置、閃爍發(fā)生在重繪的每一幀。解決不用整表綁定用DataTable作為數(shù)據(jù)源掃碼時(shí)只在 DataTable 上新增行或更新已有行DataGridView 會(huì)自動(dòng)增量刷新?；蛘呓壎˙indingListT后在界面線程上添加元素盡量避免直接重新DataSource 。private DataTable _inOrderTable; private void InitInOrderTable() { _inOrderTable new DataTable(); _inOrderTable.Columns.Add(MaterialCode, typeof(string)); _inOrderTable.Columns.Add(MaterialName, typeof(string)); _inOrderTable.Columns.Add(Quantity, typeof(decimal)); _dgvInOrder.DataSource _inOrderTable; } private void AddOrUpdateInOrder(string code, string name) { DataRow[] rows _inOrderTable.Select($MaterialCode {code}); if (rows.Length 0) { rows[0][Quantity] (decimal)rows[0][Quantity] 1; } else { _inOrderTable.Rows.Add(code, name, 1); } }這樣做的好處是同一條碼連續(xù)掃描時(shí)自動(dòng)累加數(shù)量不用每次掃完都重新綁定整個(gè)數(shù)據(jù)源。工作流也更順手倉(cāng)庫(kù)入庫(kù)時(shí)同一物料一整托都是同一個(gè)編碼操作員連續(xù)掃幾下然后看數(shù)量對(duì)不對(duì)就行這是實(shí)際項(xiàng)目里很常見(jiàn)的操作習(xí)慣。5.3 數(shù)據(jù)庫(kù)連接未釋放導(dǎo)致“數(shù)據(jù)庫(kù)被鎖定”現(xiàn)象運(yùn)行幾小時(shí)后SQLite 數(shù)據(jù)操作開(kāi)始報(bào)database is locked。原因SQLite 的寫(xiě)入鎖在using塊結(jié)束時(shí)才釋放但 C# 里如果用了靜態(tài)連接或者某個(gè)連接沒(méi)有及時(shí) Dispose文件句柄就會(huì)被一直持有。尤其是掃碼槍觸發(fā)事件頻繁的場(chǎng)景事件處理器里如果開(kāi)了連接沒(méi)關(guān)鎖越積越多。解決嚴(yán)格遵循“方法內(nèi)創(chuàng)建連接方法內(nèi)釋放”的原則。每個(gè)數(shù)據(jù)庫(kù)操作方法里都用using var conn new SQLiteConnection(...)不要在類(lèi)級(jí)別共享連接。排查時(shí)用 Process Explorer 看哪個(gè)進(jìn)程占用了 warehouse.db 文件句柄關(guān)閉程序后看句柄是否消失。數(shù)據(jù)庫(kù)寫(xiě)入前還可以設(shè)置一個(gè)超時(shí)參數(shù)來(lái)自我保護(hù)var conn new SQLiteConnection(_connString); using (var cmd new SQLiteCommand(sql, conn)) { // 單條寫(xiě)入等待鎖的毫秒數(shù)超過(guò)直接報(bào)錯(cuò)而不是無(wú)限等待 cmd.CommandTimeout 5000; }這里 CommandTimeout 在 SQLite 里的語(yǔ)義是等待鎖的超時(shí)時(shí)間不是查詢(xún)執(zhí)行時(shí)間這個(gè)參數(shù)常被忽略。5.4 盤(pán)點(diǎn)時(shí)同一物料被反復(fù)掃入多行現(xiàn)象盤(pán)點(diǎn)單上同一個(gè)物料被掃描了三次實(shí)盤(pán)數(shù)量變成 3但實(shí)際貨架上只有 1 件。原因掃描結(jié)果的累加邏輯寫(xiě)錯(cuò)了。有些開(kāi)發(fā)者用“新增行”的方式處理掃描輸入掃一次加一行盤(pán)點(diǎn)數(shù)量必須去匯總才能得到實(shí)盤(pán)數(shù)。解決入庫(kù)和盤(pán)點(diǎn)操作的掃描處理邏輯統(tǒng)一為“先查后加”。掃碼后先看待處理列表里有沒(méi)有同編碼記錄有就加數(shù)量沒(méi)有才新增行。這樣操作員掃 3 次同一物料列表里始終一行顯示 3視覺(jué)效果明確不會(huì)因?yàn)橹貜?fù)行引發(fā)誤判。5.5 條碼包含特殊字符導(dǎo)致 SQL 查詢(xún)報(bào)語(yǔ)法錯(cuò)誤現(xiàn)象掃某個(gè)條碼時(shí)程序報(bào)錯(cuò)“SQLite error near ... syntax error”換了另一個(gè)條碼卻正常。原因條碼內(nèi)容里有單引號(hào)。部分物料編碼體系里包含撇號(hào)或空格直接拼 SQL 字符串時(shí)引號(hào)轉(zhuǎn)義出了亂子。解決所有參數(shù)一律用Parameters.AddWithValue杜絕字符串拼接。不僅是條碼查詢(xún)所有用戶(hù)輸入和掃碼輸入都必須走參數(shù)化。這不只是防 SQL 注入更是防條碼內(nèi)容里的合法特殊字符把 SQL 搞崩。// 反例掃碼內(nèi)容拼進(jìn) SQL string sql $SELECT * FROM Material WHERE MaterialCode {barcode}; // 如果 barcode ABC-001 OR 11整條 SQL 語(yǔ)義全變 // 正例參數(shù)化查詢(xún) string sql SELECT * FROM Material WHERE MaterialCode code; cmd.Parameters.AddWithValue(code, barcode);有些倉(cāng)庫(kù)的條碼規(guī)則里會(huì)有空格和#、、/這類(lèi)符號(hào)參數(shù)化一步到位能少踩很多坑。6. 進(jìn)階驗(yàn)證與收尾用模擬掃碼槍跑通全流程再看庫(kù)存回滾系統(tǒng)的核心鏈路開(kāi)發(fā)完畢不做一次完整的模擬驗(yàn)證直接交付給倉(cāng)庫(kù)現(xiàn)場(chǎng)翻車(chē)的概率很高。我的做法是寫(xiě)一個(gè)“模擬掃碼”窗口用程序批量生成 Code 128 條碼圖片再用軟件模擬按鍵事件讓主程序接收——這樣在沒(méi)有硬件掃碼槍的情況下就能驗(yàn)證入庫(kù)、出庫(kù)、盤(pán)點(diǎn)三條主線的完整閉環(huán)。模擬掃碼和真實(shí)掃碼槍的差別主要在輸入速度USB 掃碼槍在幾十毫秒內(nèi)輸入完一串字符模擬器需要加一個(gè)極小間隔才能復(fù)現(xiàn)真實(shí)節(jié)奏我一般設(shè)置 30ms 間隔太快的模擬反而會(huì)讓接收端丟字符。庫(kù)存回滾驗(yàn)證是最值得做的一步故意構(gòu)造一份庫(kù)存不足的出庫(kù)單點(diǎn)擊確認(rèn)出庫(kù)看事務(wù)是否回滾、界面是否提示、數(shù)據(jù)庫(kù)庫(kù)存是否紋絲不動(dòng)。這步測(cè)試能一次性排除很多連開(kāi)發(fā)階段都發(fā)現(xiàn)不了的怪問(wèn)題。驗(yàn)證時(shí)我會(huì)在事務(wù)的 UPDATE 里臨時(shí)加輸出打印把每次更新的 SQL 語(yǔ)句和影響行數(shù)打到控制臺(tái)逐步核對(duì)出庫(kù)數(shù)量的數(shù)學(xué)邏輯。還有一個(gè)容易被遺忘的環(huán)節(jié)操作日志表。條碼倉(cāng)庫(kù)系統(tǒng)的操作員文化程度參差不齊誤掃、漏掃、重復(fù)掃是常態(tài)。我在系統(tǒng)里加了一張 Log 表記錄每次掃碼的條碼內(nèi)容、操作類(lèi)型、操作人、時(shí)間、對(duì)應(yīng)的單據(jù)號(hào)不參與業(yè)務(wù)邏輯只做審計(jì)和排錯(cuò)。某天操作員說(shuō)“我明明掃了庫(kù)存沒(méi)變”查日志一眼就能定位是掃描沒(méi)被處理還是庫(kù)存被后續(xù)操作覆蓋。這套系統(tǒng)的價(jià)值不在于用了多少高深的技術(shù)——C# 的委托、LINQ、異步編程在這里都不是必需品真正核心的是把條碼掃描這個(gè)物理動(dòng)作和數(shù)據(jù)庫(kù)事務(wù)綁定的嚴(yán)謹(jǐn)度。我見(jiàn)過(guò)太多版本在 WinForms 里堆了一堆控件、畫(huà)了幾個(gè)炫酷界面但庫(kù)存事務(wù)一塌糊涂最后倉(cāng)庫(kù)用了一周就退回 Excel?；A(chǔ)的東西做到位系統(tǒng)才真正立得住。把最簡(jiǎn)單的掃一下、加庫(kù)存、扣庫(kù)存做穩(wěn)做扎實(shí)整個(gè)倉(cāng)庫(kù)條碼管理系統(tǒng)的地基就有了。今天的方案分享就到這里這套代碼的思路和避坑點(diǎn)也希望能幫到你。本文還有配套的精品資源點(diǎn)擊獲取