简介面向Windows应用开发者的C# USB扫描枪读取示例项目解决库存、收银等场景中条形码快速自动录入问题。项目基于SerialPort类实现串口通信完整演示初始化串口参数、订阅DataReceived事件并通过Invoke机制安全地将扫码枪数据填充到无焦点文本框对中初级开发者有直接参考价值。RAR压缩包共25个文件包含7个C#源码文件、解决方案与工程配置、3个可运行exe、资源与调试符号文件等整体仅48KB结构清晰便于复用。已有8286人学习下载代码展示SerialPort对象创建、事件处理、UI线程更新等关键片段并配有Form界面与完整工程可在此基础上扩展连接检测、异常处理与参数配置提升开发效率。 做C#上位机的朋友迟早会遇到一个需求让USB扫描枪把条码扫进系统。我在做门店收银、库存盘点和票券核销这一类项目时为这个需求折腾过好几轮——刚拿到扫描枪时以为它就是个高级键盘插上就能用真写到代码里才发现事情没那么简单。这篇文章把我的完整踩坑过程整理出来从键盘模拟、串口直连到HID免焦点读取正好覆盖不同业务场景下的选型建议最后把几个只有实际跑过才会遇到的坑也一并交代清楚。1. 扫描枪本质上是带激光的键盘先搞清三种工作模式先说结论市面上绝大多数USB扫描枪在操作系统的眼里只有三种身份你的代码怎么写取决于你把它当成什么。第一种是键盘模拟模式HID Keyboard。扫描枪出厂默认基本都走这个模式USB插上后系统直接识别为一个标准键盘设备扫一下条码等价于有人用键盘以极快的速度把一串字符敲了进去通常末尾还会自动带一个回车。优点是不用装任何驱动、任何软件里都能用缺点是焦点在哪个输入框就输出到哪个输入框后台程序想悄悄收数据就特别别扭。第二种是USB转串口模式虚拟COM口。扫描枪内部有一个USB转串口芯片比较常见的是CP2102、FT232、CH340这一类插上电脑后会多出一个虚拟串口设备管理器里能看到COM号。此时扫描枪不再冒充键盘而是老老实实通过串口协议发数据你的程序需要主动去读这个串口。优点是完全不依赖焦点程序最小化也能收数据缺点是需要装对应芯片的驱动还要配置波特率这些参数。第三种是HID自定义设备模式也叫厂商私有协议模式。这种模式不是标准键盘协议而是扫描枪厂商自己定义的一套报表格式通常要配合厂商提供的SDK来解析。普通项目一般碰不到只有需要读取扫描枪电量、配置参数、固件版本这类高级功能时才会用到。怎么快速判断一把扫描枪当前是哪种模式最简单的办法打开电脑自带的记事本光标点在记事本里扫一下条码。如果字符出现在记事本里而且自动换了一行说明是键盘模拟模式。如果记事本里一点反应都没有但设备管理器里能找到一个COM口说明是串口模式。如果两者都没有才有可能是第三种私有模式。这个前置判断特别重要因为网上大量USB扫描枪读不到数据的求助帖十有八九是模式没搞清楚。有人以为是代码问题排查了一整天最后发现扫描枪根本就没被识别成串口设备。2. 键盘模拟模式单机收银场景最简单的一版实现如果你的程序是WinForm、有人工守着界面操作、焦点不会乱跑那键盘模拟模式其实够用了。核心思路就是放一个文本框用来接收扫描枪的输入然后在键盘事件里截获回车把这一帧数据取走。生产环境里我一般这样写窗体上放一个TextBox名字叫txtBarcode设置ImeMode为Disable防止中文输入法把字符吃掉然后把字体颜色调成和背景一样看起来就像没有输入框但焦点始终保在它身上。private void txtBarcode_KeyPress(object sender, KeyPressEventArgs e) { if (e.KeyChar (char)13) // 回车键扫描枪的结束符 { string barcode txtBarcode.Text.Trim(); if (!string.IsNullOrEmpty(barcode)) { ProcessBarcode(barcode); txtBarcode.Clear(); } e.Handled true; } else if (e.KeyChar 27) // 有的扫描枪会配ESC前缀过滤掉 { e.Handled true; } }为什么用KeyPress而不是KeyDown因为KeyPress拿到的直接是字符KeyDown拿到的是虚拟键码对于普通字母数字条码来说KeyPress明显更省事。扫描枪模拟的是逐字符敲击每个字符会触发一次KeyPress最后那个回车就是天然的一帧结束标记。这里有一个必须注意的细节扫描枪的回车后缀并不是所有型号都默认开启有些需要扫设置码手动开启有些默认是Tab键。如果你发现扫码后事件一直不触发先不要怀疑代码拿另一把键盘按一下回车试试看事件能不能触发能的话说明是扫描枪后缀配置不对去说明书里找添加回车后缀的设置码扫一遍就好了。而且我不建议用TextChanged事件去处理条码数据。TextChanged在输入过程中会触发很多次比如扫描ABC123它会触发6次每次数据都不完整。虽然可以配合定时器做防抖但远不如捕获回车作为结束来得干净。这个方案的另一个缺点是防不住焦点丢失。如果你的窗体内还有其他输入框用户用鼠标点了一下别的地方焦点跑了扫描枪的数据就会跑到那个控件上甚至跑到Form外面那这条数据就丢了。所以要保证txtBarcode的焦点一直在。可以用LostFocus事件强制把焦点抢回来方法比较粗暴但有效private void txtBarcode_LostFocus(object sender, EventArgs e) { txtBarcode.Focus(); }这套方案适合什么场景比如门店收银台操作员固定坐在电脑前扫码录商品界面简单一个框收数据就够用。抖音团购核销、电影票核销这类有人值守的轻量场景键盘模拟模式完全能扛住。3. 串口模式做上位机项目更推荐的读取方式一旦你的程序需要在后台静默收数、程序最小化时也在监听、或者界面焦点经常被其他控件抢走那就别在键盘模式里死磕了直接把扫描枪切到串口模式。切换方法一般是从说明书里找USB串口模式或USB COM口模式的设置码扫一下就能切换。有些型号还支持键盘模拟串口同时输出这种是最舒服的既可以人工用记事本验证又可以让程序通过串口收数。切到串口模式后先确认设备管理器里能看到COM号然后C#里用System.IO.Ports.SerialPort来读取。参数通常这样配置SerialPort _port new SerialPort(COM3, 9600, Parity.None, 8, StopBits.One); _port.DataReceived Port_DataReceived; _port.Open();波特率这块多说一句绝大多数国产扫描枪默认是9600有些新款的默认是115200最稳妥的办法是看说明书或者打开串口调试助手一个个波特率试过去。另外USB虚拟串口和真正的RS232不太一样USB CDC虚拟串口的波特率设置很多时候只是形式上管用实际数据不校验波特率但你还是得正确配置不然驱动层面可能不工作。DataReceived事件运行在后台线程不能直接在事件里操作UI控件这是无数新手第一个翻车点。处理数据的时候也尽量不要用SerialPort.ReadExisting直接一次读完就完事因为扫描枪发数据虽然是一瞬间的事但你的程序接收时可能会被拆成多个数据包到达。最稳妥的办法是维护一个缓存不断追加收到的数据遇到换行符就认定是一帧完整数据。我这边的标准写法private readonly StringBuilder _buffer new StringBuilder(); private void Port_DataReceived(object sender, SerialDataReceivedEventArgs e) { try { var sp (SerialPort)sender; string chunk sp.ReadExisting(); _buffer.Append(chunk); while (true) { string current _buffer.ToString(); int idx current.IndexOf(\n); if (idx 0) break; string line current.Substring(0, idx).TrimEnd(\r); _buffer.Remove(0, idx 1); if (!string.IsNullOrEmpty(line)) { string barcode line; if (this.IsHandleCreated !this.IsDisposed) { BeginInvoke(new Action(() ProcessBarcode(barcode))); } } } } catch (Exception ex) { LogError(ex); } }用StringBuilder做缓冲的好处是哪怕数据被拆成三五个包只要最终以换行符结尾程序都能完整拼回来。判断结束符时用\n而不是\r因为扫描枪默认的发帧格式是回车换行\r\n按\n切再去掉前面的\r逻辑最简单。还有一个实用功能是自动枚举串口。很多USB转串口设备在设备管理器里的名字会带芯片信息比如USB-Enhanced-SERIAL CH340 (COM3)。你可以用ManagementObjectSearcher去查询Win32_PnPEntity里名称带COM的设备把串口号列出来给用户选。这个功能在客户现场特别有用因为客户电脑上可能插了多个USB转串口设备你列一个下拉框让他自己选比写死COM3要靠谱得多。using System.Management; private void RefreshComPorts() { comboBoxPorts.Items.Clear(); var searcher new ManagementObjectSearcher(SELECT * FROM Win32_PnPEntity); foreach (ManagementObject obj in searcher.Get()) { string name obj[Name]?.ToString(); if (!string.IsNullOrEmpty(name) name.Contains((COM)) { int start name.LastIndexOf((COM, StringComparison.Ordinal); int end name.IndexOf(), start, StringComparison.Ordinal); if (start 0 end start) { comboBoxPorts.Items.Add(name.Substring(start 1, end - start - 1)); } } } }这样列出来的每个串口号都带着设备描述比单纯SerialPort.GetPortNames()返回的COM3直观得多客户也更容易看懂。4. 免焦点方案用HID原始输入在后台接住扫码数据串口模式解决了很多问题但有一种场景绕不开HID原始输入扫描枪的型号很老或者很特殊不支持切串口模式又或者公司规定不能装USB转串口驱动这时候你要接收数据就只能用原始输入Raw Input了。Raw Input是Windows提供的一套机制允许程序直接接收输入设备的原始数据哪怕你的程序没有焦点只要注册了对应设备就能收到它发来的按键消息。这个方案在无人值守的自助终端上经常用程序全屏跑着但不需要任何输入框扫描枪一响数据就进去了。用在C#里需要做P/Invoke。首先是注册设备时用的结构体和API[StructLayout(LayoutKind.Sequential)] internal struct RAWINPUTDEVICE { public ushort UsagePage; public ushort Usage; public uint Flags; public IntPtr Target; } [DllImport(user32.dll)] private static extern bool RegisterRawInputDevices( RAWINPUTDEVICE[] pRawInputDevices, uint uiNumDevices, uint cbSize);注册键盘设备时UsagePage设为0x01Usage设为0x06Flags用RIDEV_INPUTSINK这样即使程序没有焦点也能接收。代码里的Target传IntPtr.Zero表示把消息发到注册线程的窗口。注册代码RAWINPUTDEVICE[] rid new RAWINPUTDEVICE[1]; rid[0].UsagePage 0x01; rid[0].Usage 0x06; rid[0].Flags 0x00000100; // RIDEV_INPUTSINK rid[0].Target IntPtr.Zero; RegisterRawInputDevices(rid, 1, (uint)Marshal.SizeOf(typeof(RAWINPUTDEVICE)));注册之后在窗体里重写WndProc拦截WM_INPUT消息。WM_INPUT的lParam参数指向一段RAWINPUT数据先用GetRawInputData把数据读出来再从中取出按键码。private const int WM_INPUT 0x00FF; private const int RID_INPUT 0x10000003; protected override void WndProc(ref Message m) { if (m.Msg WM_INPUT) { uint size 0; GetRawInputData(m.LParam, RID_INPUT, IntPtr.Zero, ref size, (uint)Marshal.SizeOf(typeof(RAWINPUTHEADER))); IntPtr buffer Marshal.AllocHGlobal((int)size); try { if (GetRawInputData(m.LParam, RID_INPUT, buffer, ref size, (uint)Marshal.SizeOf(typeof(RAWINPUTHEADER))) size) { // 从缓冲区偏移头结构大小之后读取RAWKEYBOARD IntPtr keyboardPtr IntPtr.Add(buffer, Marshal.SizeOf(typeof(RAWINPUTHEADER))); RAWKEYBOARD keyboard (RAWKEYBOARD)Marshal.PtrToStructure( keyboardPtr, typeof(RAWKEYBOARD)); if (keyboard.VKey 0x0D) // 回车一帧结束 { ProcessBarcode(_rawBuffer.ToString()); _rawBuffer.Clear(); } else { uint ch MapVirtualKey(keyboard.VKey, 2); if (ch ! 0) { _rawBuffer.Append((char)(ch 0xFFFF)); } } } } finally { Marshal.FreeHGlobal(buffer); } } base.WndProc(ref m); }这里用到的RAWINPUTHEADER和RAWKEYBOARD是标准Windows结构体定义可以从微软文档里抄字段分别是dwType、dwSize、hDevice、wParam以及MakeCode、Flags、Reserved、VKey、Message、ExtraInformation。我建议在用之前先在记事本程序里验证一下——开着这个程序扫一下条码能正常显示再往实际项目里搬排查起来会省事很多。Raw Input最大的优点是彻底甩开了焦点和输入法不需要界面上有输入框也不需要锁定焦点程序完全在后台接数据。缺点也很明显代码量变大而且它会收到所有键盘设备的输入包括你自己用的普通键盘。如果不做设备过滤你敲键盘打字的字符也会混进扫码数据里。过滤办法是用GetRawInputDeviceInfo拿到当前设备的设备名形如\?\HID#VID_XXXXPID_XXXX#...然后判断这个设备的VID、PID是不是扫描枪的。更简单一点的思路是只在非打字状态下启用监听或者干脆把普通键盘的输入也接收进来但只处理扫描帧。实际项目中我通常是把设备名打成日志看一次扫描枪的实际设备名然后做个名单过滤。5. 实战中反复踩过的坑每个都能让你排查到崩溃5.1 在KeyDown里弹MessageBox回车键造成连锁反应这是网上问的最多的问题我自己也中过招。场景很简单扫完码判断条码在不在数据库里不在就弹个MessageBox提示条码不存在。看似正常的逻辑跑起来却会出现诡异现象点掉弹窗之后扫码事件又被触发了一次甚至连续触发像程序抽风一样。原因是MessageBox自身是一个模态窗口它会进入一个新的消息循环。扫描枪回车键触发KeyDown事件时如果你在事件里弹了MessageBox那么MessageBox打开后回车键的按键消息会在MessageBox的消息循环里再次被处理可能会再次触发同一个KeyDown形成连锁。解决方式很简单绝对不要在KeyDown或KeyPress的同步链路里直接弹MessageBox。要么用BeginInvoke把弹窗延迟到当前消息处理完之后private void ProcessBarcode(string barcode) { if (barcode NOT_FOUND) { BeginInvoke(new Action(() { MessageBox.Show(条码不存在); })); } }要么干脆把错误提示写入一个列队界面定时刷新时再展示。我建议后者因为连续扫多个无效条码时弹窗会让人烦死。5.2 输入法全角污染扫出来的是全角数字做字典查询的客户现场电脑装了搜狗输入法扫描枪扫出来的条码里的数字变成了全角数字数据库里存的是半角12345自然是查不到。原因很简单键盘模拟模式下扫描枪把每个字符模拟成一次键盘按键而这些按键经过输入法的时候输入法对全角/半角做了转换。解决办法有三个。最省事的是把接收用的TextBox的ImeMode属性设为Disable这是WinForm里针对这个场景最常见的处理。但如果你用Raw Input接数据其实不经过输入法天然没这个烦恼这算是免焦点方案的额外好处。还有一个兜底办法是代码里把全角数字转半角private static string ToHalfWidth(string input) { char[] chars input.ToCharArray(); for (int i 0; i chars.Length; i) { if (chars[i] \uFF10 chars[i] \uFF19) chars[i] (char)(chars[i] - \uFF10 0); } return new string(chars); }5.3 客户现场串口号漂移开发时用COM3一切正常到了客户现场扫描枪插入不同USB口之后串口号变成COM5、COM7程序写死COM3就读不到。这不是代码逻辑问题而是USB设备枚举的顺序不固定导致的。我的处理习惯是程序启动时自动扫一遍系统当前所有COM口通过设备名判断哪一个是扫描枪弹窗让用户确认并且界面上保留一个重新检测串口按钮。尽量不要相信固定串口号。如果项目要求完全无人值守就根据VID/PID精确匹配扫描枪的USB设备然后用注册表或者WMI把设备名和COM号的关系找出来。5.4 DataReceived的线程问题SerialPort的DataReceived事件是后台线程触发的直接在里面改TextBox.Text偶尔抛异常偶尔不抛属于非常薛定谔的Bug。等你在客户现场复现不出来的时候它又在我们自己电脑上稳定复现。正确姿势就是用BeginInvoke切回UI线程并判断窗体是否已释放防止程序关闭时后台线程还在调用回调引发ObjectDisposedException。5.5 数据长度被截断或者偶尔丢一位这种问题多半不是代码问题是物理链路问题。有次客户反馈扫码偶发少一位排查了很久最后发现是他们图省事用了一根劣质USB延长线供电不稳扫描枪在高强度连续扫码时偶尔丢字符。换了一根带屏蔽的线以后问题消失。遇到丢码、乱码先换线、换USB口试试别急着怀疑程序。另外扫描枪的USB接口如果插在USB HUB上尽量选有供电的HUB无供电HUB供电波动会直接影响扫码头。5.6 新枪到手第一步用记事本确定模式我现在的习惯是拿到新扫描枪第一件事不是写代码而是打开记事本扫一下。光标出现在记事本并回车换行说明是键盘模式没反应但设备管理器里多了COM口说明是串口模式。这个步骤能帮你省掉一大半排查时间。然后拿手机扫几个测试码注意看有没有前缀后缀再决定代码里要不要做Trim或过滤。结尾一点小建议扫描枪这套东西代码本身不复杂真正花时间的是搞清楚它的工作模式和你项目的业务形态。我的建议很简单有人值守、有界面焦点的场景用键盘模拟省事后台收数、多工位并发、无人值守的场景优先切串口碰到不能装驱动又不能切换模式的硬骨头再上HID原始输入。按这条线走基本不会踩大坑。做这个功能的时候我一直习惯把设备信息和调试日志保留在软件里就算出了问题客户也能把日志发回来分析比自己盲猜高效得多。本文还有配套的精品资源点击获取