简介本资源为基于 DevExpress v23.1 开发的固定式扫码系统 C# 源码面向从事工业自动化、产线数据采集与上位机开发的 C# 工程师及学习者。项目围绕固定式扫码枪的串口通信展开封装了 SerialPort 工具类包含串口对象管理、接收状态控制与数据变更事件回调等核心逻辑并完善了扫描报警与数据库查询功能可直接用于产线扫码追溯、条码采集等场景的二次开发。压缩包共 572 个文件约 120.67MB以 170 个 dll 依赖库、107 个 xml 配置文档、28 个 cs 源码文件为主另含 nupkg 包、pdb 调试文件、resx 资源及 sln 解决方案等工程结构完整。目前已有 175 人学习下载。读者可获取一套可直接编译运行的扫码系统源码理解串口通信封装、报警触发与数据库查询的完整实现思路适合作为上位机项目参考或功能扩展的基础框架。1. 拆开一套 DevExpress v23.1 固定式扫码系统 C# 源码它到底能跑在什么场景里产线上扫码枪怼着流水线工控机屏幕上要实时弹出产品条码、批次、时间还要把数据写进本地库、断网了不能丢、操作员点两下就能查历史——这种需求在制造业、仓储、质检环节里遍地都是。这套 DevExpress v23.1 固定式扫码系统 C# 源码就是冲着这类固定工位场景去的扫码枪走串口或 USB 键盘口输入WinForms 界面用 DevExpress 控件搭数据落本地数据库附带查询、导出、日志。它不是那种跑在手机上的扫码 App也不是云端 SaaS而是装在工控机或办公 PC 上的桌面端程序适合做设备集成、产线追溯、出入库登记的开发者直接拿来改。源码基于 .NET Framework 和 DevExpress v23.1 控件库拿到手先别急着 F5环境对不上会直接翻车。2. 环境搭建与 DevExpress v23.1 引用从零到能编译2.1 为什么这套源码挑环境以及怎么选对版本DevExpress 的控件库版本和 .NET 运行时是强绑定的。v23.1 这个版本号意味着它对应的 DevExpress 程序集是 23.1.x如果你机器上装的是 v22.2 或 v24.1打开解决方案时引用会飘红设计器里的 GridControl、TextEdit 全部报“找不到类型”。常见做法是去 DevExpress 官网下载 v23.1 的安装包安装时勾选 WinForms 组件安装完成后在 Visual Studio 里通过 NuGet 或本地程序集路径引用。注意 DevExpress 不是免费控件库没有授权的话编译能过但运行时会弹试用提示正式项目得走授权流程。另一个坑是 .NET 版本。这套源码大概率是 .NET Framework 4.7.2 或 4.8因为 DevExpress v23.1 对 .NET Core / .NET 5 的 WinForms 支持虽然有了但很多老项目还是 Framework。你打开 .csproj 文件看 TargetFrameworkVersion 那一行如果是 v4.7.2就别用 .NET 6 的 SDK 去开直接装 Visual Studio 2022 并勾选“.NET 桌面开发”工作负载Framework 版本在 Windows 功能里单独启用。2.2 引用修复与首次编译的完整步骤假设你已经装好 DevExpress v23.1 和 Visual Studio接下来按顺序走# 第一步确认 DevExpress 安装路径下的程序集存在 # 默认路径类似 C:\Program Files\DevExpress 23.1\Components\Bin\Framework # 进去看有没有 DevExpress.XtraEditors.v23.1.dll 这类文件 dir C:\Program Files\DevExpress 23.1\Components\Bin\Framework\DevExpress.Xtra*.dll这一步是确认控件库真的装上了。如果目录不存在说明安装时没勾选 WinForms 组件重新跑安装程序补上。!-- 第二步检查 .csproj 里的引用路径常见写法是 HintPath 指向绝对路径 -- Reference IncludeDevExpress.XtraEditors.v23.1, Version23.1.3.0, Cultureneutral, PublicKeyTokenb88d1754d700e49a HintPathC:\Program Files\DevExpress 23.1\Components\Bin\Framework\DevExpress.XtraEditors.v23.1.dll/HintPath /Reference如果 HintPath 指向的是源码作者机器上的路径比如D:\DevExpress\...你得改成自己机器上的实际路径。批量改的话在 Visual Studio 里右键项目 → 管理 NuGet 程序包 → 搜索 DevExpress.WinForms装对应版本NuGet 会自动处理引用路径比手动改 HintPath 省事。// 第三步编译前检查 Program.cs 里的启动逻辑 static void Main() { Application.EnableVisualStyles(); Application.SetCompatibleTextRenderingDefault(false); // 有些源码会在这里做授权初始化或全局异常捕获 Application.Run(new MainForm()); }编译报错集中在两类一是 DevExpress 程序集版本不匹配二是缺少第三方依赖比如串口通信用了 System.IO.Ports需要额外引用。前者用 NuGet 统一版本后者在 NuGet 里搜包名装上。编译通过后先别接扫码枪直接 F5 跑起来看主界面能不能正常渲染GridControl 有没有数据列这能排除掉大部分控件层面的问题。3. 扫码输入链路串口、键盘口与数据解析的落地细节3.1 固定式扫码枪的两种接入方式与选型固定式扫码系统里扫码枪和 PC 的通信方式主要两种串口RS232和 USB 键盘口HID。串口方式需要扫码枪厂商提供通信协议通常是发指令触发扫码然后读回数据适合需要精确控制触发时机的产线场景。USB 键盘口方式更简单扫码枪模拟键盘输入扫到码就相当于敲了一串字符加回车程序只要在文本框里接收就行适合操作员手动触发、对时序要求不高的工位。这套源码大概率两种都支持或者至少留了扩展点。你打开代码找 SerialPort 相关的类如果有SerialPortManager或ScanDeviceService这类命名说明串口链路是现成的。USB 键盘口的话看主窗体里有没有一个隐藏的 TextBox 或者全局键盘钩子用来捕获扫码输入。3.2 串口扫码的代码实现与参数配置串口通信的核心是配置波特率、数据位、停止位、校验位这四个参数必须和扫码枪手册一致错一个就收不到数据。// 串口初始化与数据接收的典型写法 private SerialPort _scanPort; public void OpenScanPort(string portName) { _scanPort new SerialPort { PortName portName, // 例如 COM3在设备管理器里确认 BaudRate 9600, // 常见 9600 或 115200看扫码枪手册 DataBits 8, // 固定 8 位居多 StopBits StopBits.One, // 1 位停止位 Parity Parity.None, // 无校验 ReadTimeout 500, // 读超时 500ms避免卡死 WriteTimeout 500 }; _scanPort.DataReceived OnScanDataReceived; _scanPort.Open(); } private void OnScanDataReceived(object sender, SerialDataReceivedEventArgs e) { // 注意DataReceived 在后台线程触发更新 UI 要 Invoke string raw _scanPort.ReadLine(); // 按换行符切分扫码枪一般会加 \r\n this.Invoke(new Action(() { txtScanResult.Text raw.Trim(); SaveScanRecord(raw.Trim()); // 落库 })); }参数说明BaudRate 是最容易出错的9600 和 115200 搞反了就是乱码或收不到ReadLine 依赖扫码枪发送结束符如果枪只发数据不发换行得改用 ReadExisting 加超时拼接。DataReceived 事件在后台线程跑直接操作控件会抛跨线程异常必须 Invoke 回 UI 线程这是 WinForms 串口编程的血泪经验。3.3 USB 键盘口输入的捕获与防重复USB 键盘口模式下扫码枪就是一秒敲几十个字符的键盘。如果焦点在某个文本框上数据直接进去如果焦点不在数据就丢了。常见做法是在主窗体上挂一个全局键盘钩子或者放一个始终获得焦点的隐藏 TextBox。// 用隐藏 TextBox 捕获扫码输入的简化方案 private void txtHiddenScan_KeyDown(object sender, KeyEventArgs e) { if (e.KeyCode Keys.Enter) { string code txtHiddenScan.Text.Trim(); if (!string.IsNullOrEmpty(code)) { ProcessScanCode(code); // 业务处理 } txtHiddenScan.Clear(); // 清空准备下一次 e.SuppressKeyPress true; // 阻止回车触发默认按钮 } }这里的关键是e.SuppressKeyPress true不加的话回车会触发窗体上默认按钮的 Click导致误操作。另外要防重复扫码同一个码在短时间内连续进来可能是枪的重复触发或操作员手抖业务层加一个时间窗口去重比如 500ms 内相同码只处理一次。4. 数据落库与查询导出本地存储方案与 DevExpress 控件绑定4.1 本地数据库选型SQLite 还是 SQL Server Express固定式扫码系统的数据量一般不会太大单工位一天几千到几万条记录本地存储用 SQLite 足够了。SQLite 免安装、单文件、备份就是拷文件适合工控机环境。如果产线要求多工位共享数据那就得上 SQL Server Express 或 MySQL走局域网。这套源码如果默认带的是 SQLite你会看到一个 .db 文件或者代码里有SQLiteConnection如果是 SQL Server连接字符串里会有Data Source.\SQLEXPRESS这类。选型理由SQLite 的并发写入弱多线程同时写会锁库但扫码系统通常是单线程顺序写入问题不大。SQL Server Express 有 10GB 上限对扫码记录来说也够用但部署麻烦一点。我一般建议先用 SQLite 跑通数据量真上来了再迁。4.2 建表与插入记录的代码落地-- 扫码记录表结构字段按实际业务增减 CREATE TABLE ScanRecords ( Id INTEGER PRIMARY KEY AUTOINCREMENT, ScanCode TEXT NOT NULL, -- 条码内容 ScanTime DATETIME DEFAULT CURRENT_TIMESTAMP, -- 扫码时间 StationName TEXT, -- 工位名称 OperatorName TEXT, -- 操作员 BatchNo TEXT -- 批次号 ); CREATE INDEX idx_scancode ON ScanRecords(ScanCode); CREATE INDEX idx_scantime ON ScanRecords(ScanTime);索引是必须的查询历史记录时按条码或时间过滤没索引几万条就开始卡。// 插入记录的参数化写法防 SQL 注入也防特殊字符 public void SaveScanRecord(string scanCode, string station, string operatorName) { using (var conn new SQLiteConnection(Data Sourcescan.db;Version3;)) { conn.Open(); string sql INSERT INTO ScanRecords (ScanCode, StationName, OperatorName) VALUES (code, station, op); using (var cmd new SQLiteCommand(sql, conn)) { cmd.Parameters.AddWithValue(code, scanCode); cmd.Parameters.AddWithValue(station, station); cmd.Parameters.AddWithValue(op, operatorName); cmd.ExecuteNonQuery(); } } }参数化查询不只是防注入条码里如果有单引号或特殊符号拼字符串直接报错参数化能避开这个坑。4.3 DevExpress GridControl 绑定与导出查询结果展示用 DevExpress 的 GridControl绑定 DataTable 或 List 都行。导出功能用 GridControl 自带的 ExportToXlsx 或 ExportToCsv一行代码搞定。// 查询并绑定到 GridControl private void LoadScanHistory(DateTime from, DateTime to) { string sql SELECT * FROM ScanRecords WHERE ScanTime BETWEEN from AND to ORDER BY ScanTime DESC; using (var conn new SQLiteConnection(Data Sourcescan.db;Version3;)) { var adapter new SQLiteDataAdapter(sql, conn); adapter.SelectCommand.Parameters.AddWithValue(from, from); adapter.SelectCommand.Parameters.AddWithValue(to, to); var table new DataTable(); adapter.Fill(table); gridControl1.DataSource table; // 自动生成列 } } // 导出当前视图到 Excel private void ExportToExcel() { string path $ScanHistory_{DateTime.Now:yyyyMMddHHmmss}.xlsx; gridControl1.ExportToXlsx(path); // 导出后可以自动打开文件或提示路径 }GridControl 的 DataSource 赋 DataTable 后会自动根据列名生成列如果列顺序或显示名要定制在设计器里改 Columns 集合。导出路径建议带时间戳避免覆盖。5. 避坑与排查这套源码跑起来最容易翻车的五个地方5.1 现象编译报错“未能找到类型或命名空间名 DevExpress”原因DevExpress v23.1 没装或者装了但版本不对或者 NuGet 包没还原。解决确认安装的是 v23.1 且勾选了 WinForms 组件在 Visual Studio 里右键解决方案 → 还原 NuGet 包如果 HintPath 是绝对路径改成自己机器的路径或改用 NuGet 引用。5.2 现象扫码枪接上没反应串口打不开原因COM 口号写错、被其他程序占用、或者波特率不匹配。解决设备管理器里确认 COM 号用串口调试助手先单独测试扫码枪能不能出数据检查代码里 PortName 是不是硬编码了别人的 COM3改成实际口号。如果抛“拒绝访问”说明端口被占用关掉其他串口程序。5.3 现象扫码数据能收到但界面不更新或者直接崩原因DataReceived 在后台线程触发直接操作控件导致跨线程异常。解决所有 UI 更新用this.Invoke或BeginInvoke包起来。如果崩在Invoke之前检查窗体句柄是否已创建窗体构造阶段别开串口。5.4 现象数据写入 SQLite 报“database is locked”原因多个连接同时写或者上一个连接没释放。解决确保每次操作完using释放连接如果确实有多线程写入加锁或改用单例连接加队列。SQLite 的并发写能力有限扫码系统尽量单线程顺序写。5.5 现象DevExpress 控件运行时弹试用提示或水印原因没有 DevExpress 授权或者授权信息没正确注册。解决开发阶段可以用试用版跑正式部署前得购买授权并按照 DevExpress 的授权方式在代码或配置里注册。注意别把试用版直接交付到产线弹窗会打断操作员。6. 进阶技巧把扫码记录做成可追溯的本地日志与自动备份跑通基本流程后我一般会加两件事本地日志和自动备份。扫码系统最怕的是数据丢了说不清操作员说扫了、系统说没记录扯皮的时候日志就是后悔药。日志分两层一层是业务日志每次扫码成功或失败都写一条到文本文件格式带时间戳、条码、结果另一层是数据库备份每天定时把 SQLite 文件拷到备份目录保留最近 30 天。// 简单的业务日志写入按天分文件 public static void WriteLog(string message) { string dir Path.Combine(AppDomain.CurrentDomain.BaseDirectory, Logs); Directory.CreateDirectory(dir); string file Path.Combine(dir, $scan_{DateTime.Now:yyyyMMdd}.log); string line ${DateTime.Now:yyyy-MM-dd HH:mm:ss.fff} | {message}; File.AppendAllText(file, line Environment.NewLine, Encoding.UTF8); } // 数据库备份建议放在定时器或窗体关闭时 public static void BackupDatabase(string dbPath, string backupDir) { Directory.CreateDirectory(backupDir); string target Path.Combine(backupDir, $scan_{DateTime.Now:yyyyMMddHHmmss}.db); File.Copy(dbPath, target, overwrite: true); // 清理 30 天前的备份 foreach (var f in Directory.GetFiles(backupDir, scan_*.db)) { if (File.GetCreationTime(f) DateTime.Now.AddDays(-30)) File.Delete(f); } }日志写入用 AppendAllText 简单直接但高频扫码时频繁开文件句柄有性能损耗可以改成队列加后台线程批量写。备份用 File.Copy 在数据库没写入时是安全的SQLite 支持热备份但保险起见在业务空闲时做。验证方法扫十个码看日志文件是不是十条、数据库是不是十条、备份目录有没有生成文件。然后手动删掉数据库从备份恢复看数据能不能回来。这套流程走一遍心里就有底了。从那以后我每次拿到这类扫码源码都先把日志和备份加上再交付产线上扯皮的事少一大半。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/9 15:12:56 · 阅读 1.2k DevExpress v23.1固定式扫码系统C#源码解析与实战
简介本资源为基于 DevExpress v23.1 开发的固定式扫码系统 C# 源码面向从事工业自动化、产线数据采集与上位机开发的 C# 工程师及学习者。项目围绕固定式扫码枪的串口通信展开封装了 SerialPort 工具类包含串口对象管理、接收状态控制与数据变更事件回调等核心逻辑并完善了扫描报警与数据库查询功能可直接用于产线扫码追溯、条码采集等场景的二次开发。压缩包共 572 个文件约 120.67MB以 170 个 dll 依赖库、107 个 xml 配置文档、28 个 cs 源码文件为主另含 nupkg 包、pdb 调试文件、resx 资源及 sln 解决方案等工程结构完整。目前已有 175 人学习下载。读者可获取一套可直接编译运行的扫码系统源码理解串口通信封装、报警触发与数据库查询的完整实现思路适合作为上位机项目参考或功能扩展的基础框架。1. 拆开一套 DevExpress v23.1 固定式扫码系统 C# 源码它到底能跑在什么场景里产线上扫码枪怼着流水线工控机屏幕上要实时弹出产品条码、批次、时间还要把数据写进本地库、断网了不能丢、操作员点两下就能查历史——这种需求在制造业、仓储、质检环节里遍地都是。这套 DevExpress v23.1 固定式扫码系统 C# 源码就是冲着这类固定工位场景去的扫码枪走串口或 USB 键盘口输入WinForms 界面用 DevExpress 控件搭数据落本地数据库附带查询、导出、日志。它不是那种跑在手机上的扫码 App也不是云端 SaaS而是装在工控机或办公 PC 上的桌面端程序适合做设备集成、产线追溯、出入库登记的开发者直接拿来改。源码基于 .NET Framework 和 DevExpress v23.1 控件库拿到手先别急着 F5环境对不上会直接翻车。2. 环境搭建与 DevExpress v23.1 引用从零到能编译2.1 为什么这套源码挑环境以及怎么选对版本DevExpress 的控件库版本和 .NET 运行时是强绑定的。v23.1 这个版本号意味着它对应的 DevExpress 程序集是 23.1.x如果你机器上装的是 v22.2 或 v24.1打开解决方案时引用会飘红设计器里的 GridControl、TextEdit 全部报“找不到类型”。常见做法是去 DevExpress 官网下载 v23.1 的安装包安装时勾选 WinForms 组件安装完成后在 Visual Studio 里通过 NuGet 或本地程序集路径引用。注意 DevExpress 不是免费控件库没有授权的话编译能过但运行时会弹试用提示正式项目得走授权流程。另一个坑是 .NET 版本。这套源码大概率是 .NET Framework 4.7.2 或 4.8因为 DevExpress v23.1 对 .NET Core / .NET 5 的 WinForms 支持虽然有了但很多老项目还是 Framework。你打开 .csproj 文件看 TargetFrameworkVersion 那一行如果是 v4.7.2就别用 .NET 6 的 SDK 去开直接装 Visual Studio 2022 并勾选“.NET 桌面开发”工作负载Framework 版本在 Windows 功能里单独启用。2.2 引用修复与首次编译的完整步骤假设你已经装好 DevExpress v23.1 和 Visual Studio接下来按顺序走# 第一步确认 DevExpress 安装路径下的程序集存在 # 默认路径类似 C:\Program Files\DevExpress 23.1\Components\Bin\Framework # 进去看有没有 DevExpress.XtraEditors.v23.1.dll 这类文件 dir C:\Program Files\DevExpress 23.1\Components\Bin\Framework\DevExpress.Xtra*.dll这一步是确认控件库真的装上了。如果目录不存在说明安装时没勾选 WinForms 组件重新跑安装程序补上。!-- 第二步检查 .csproj 里的引用路径常见写法是 HintPath 指向绝对路径 -- Reference IncludeDevExpress.XtraEditors.v23.1, Version23.1.3.0, Cultureneutral, PublicKeyTokenb88d1754d700e49a HintPathC:\Program Files\DevExpress 23.1\Components\Bin\Framework\DevExpress.XtraEditors.v23.1.dll/HintPath /Reference如果 HintPath 指向的是源码作者机器上的路径比如D:\DevExpress\...你得改成自己机器上的实际路径。批量改的话在 Visual Studio 里右键项目 → 管理 NuGet 程序包 → 搜索 DevExpress.WinForms装对应版本NuGet 会自动处理引用路径比手动改 HintPath 省事。// 第三步编译前检查 Program.cs 里的启动逻辑 static void Main() { Application.EnableVisualStyles(); Application.SetCompatibleTextRenderingDefault(false); // 有些源码会在这里做授权初始化或全局异常捕获 Application.Run(new MainForm()); }编译报错集中在两类一是 DevExpress 程序集版本不匹配二是缺少第三方依赖比如串口通信用了 System.IO.Ports需要额外引用。前者用 NuGet 统一版本后者在 NuGet 里搜包名装上。编译通过后先别接扫码枪直接 F5 跑起来看主界面能不能正常渲染GridControl 有没有数据列这能排除掉大部分控件层面的问题。3. 扫码输入链路串口、键盘口与数据解析的落地细节3.1 固定式扫码枪的两种接入方式与选型固定式扫码系统里扫码枪和 PC 的通信方式主要两种串口RS232和 USB 键盘口HID。串口方式需要扫码枪厂商提供通信协议通常是发指令触发扫码然后读回数据适合需要精确控制触发时机的产线场景。USB 键盘口方式更简单扫码枪模拟键盘输入扫到码就相当于敲了一串字符加回车程序只要在文本框里接收就行适合操作员手动触发、对时序要求不高的工位。这套源码大概率两种都支持或者至少留了扩展点。你打开代码找 SerialPort 相关的类如果有SerialPortManager或ScanDeviceService这类命名说明串口链路是现成的。USB 键盘口的话看主窗体里有没有一个隐藏的 TextBox 或者全局键盘钩子用来捕获扫码输入。3.2 串口扫码的代码实现与参数配置串口通信的核心是配置波特率、数据位、停止位、校验位这四个参数必须和扫码枪手册一致错一个就收不到数据。// 串口初始化与数据接收的典型写法 private SerialPort _scanPort; public void OpenScanPort(string portName) { _scanPort new SerialPort { PortName portName, // 例如 COM3在设备管理器里确认 BaudRate 9600, // 常见 9600 或 115200看扫码枪手册 DataBits 8, // 固定 8 位居多 StopBits StopBits.One, // 1 位停止位 Parity Parity.None, // 无校验 ReadTimeout 500, // 读超时 500ms避免卡死 WriteTimeout 500 }; _scanPort.DataReceived OnScanDataReceived; _scanPort.Open(); } private void OnScanDataReceived(object sender, SerialDataReceivedEventArgs e) { // 注意DataReceived 在后台线程触发更新 UI 要 Invoke string raw _scanPort.ReadLine(); // 按换行符切分扫码枪一般会加 \r\n this.Invoke(new Action(() { txtScanResult.Text raw.Trim(); SaveScanRecord(raw.Trim()); // 落库 })); }参数说明BaudRate 是最容易出错的9600 和 115200 搞反了就是乱码或收不到ReadLine 依赖扫码枪发送结束符如果枪只发数据不发换行得改用 ReadExisting 加超时拼接。DataReceived 事件在后台线程跑直接操作控件会抛跨线程异常必须 Invoke 回 UI 线程这是 WinForms 串口编程的血泪经验。3.3 USB 键盘口输入的捕获与防重复USB 键盘口模式下扫码枪就是一秒敲几十个字符的键盘。如果焦点在某个文本框上数据直接进去如果焦点不在数据就丢了。常见做法是在主窗体上挂一个全局键盘钩子或者放一个始终获得焦点的隐藏 TextBox。// 用隐藏 TextBox 捕获扫码输入的简化方案 private void txtHiddenScan_KeyDown(object sender, KeyEventArgs e) { if (e.KeyCode Keys.Enter) { string code txtHiddenScan.Text.Trim(); if (!string.IsNullOrEmpty(code)) { ProcessScanCode(code); // 业务处理 } txtHiddenScan.Clear(); // 清空准备下一次 e.SuppressKeyPress true; // 阻止回车触发默认按钮 } }这里的关键是e.SuppressKeyPress true不加的话回车会触发窗体上默认按钮的 Click导致误操作。另外要防重复扫码同一个码在短时间内连续进来可能是枪的重复触发或操作员手抖业务层加一个时间窗口去重比如 500ms 内相同码只处理一次。4. 数据落库与查询导出本地存储方案与 DevExpress 控件绑定4.1 本地数据库选型SQLite 还是 SQL Server Express固定式扫码系统的数据量一般不会太大单工位一天几千到几万条记录本地存储用 SQLite 足够了。SQLite 免安装、单文件、备份就是拷文件适合工控机环境。如果产线要求多工位共享数据那就得上 SQL Server Express 或 MySQL走局域网。这套源码如果默认带的是 SQLite你会看到一个 .db 文件或者代码里有SQLiteConnection如果是 SQL Server连接字符串里会有Data Source.\SQLEXPRESS这类。选型理由SQLite 的并发写入弱多线程同时写会锁库但扫码系统通常是单线程顺序写入问题不大。SQL Server Express 有 10GB 上限对扫码记录来说也够用但部署麻烦一点。我一般建议先用 SQLite 跑通数据量真上来了再迁。4.2 建表与插入记录的代码落地-- 扫码记录表结构字段按实际业务增减 CREATE TABLE ScanRecords ( Id INTEGER PRIMARY KEY AUTOINCREMENT, ScanCode TEXT NOT NULL, -- 条码内容 ScanTime DATETIME DEFAULT CURRENT_TIMESTAMP, -- 扫码时间 StationName TEXT, -- 工位名称 OperatorName TEXT, -- 操作员 BatchNo TEXT -- 批次号 ); CREATE INDEX idx_scancode ON ScanRecords(ScanCode); CREATE INDEX idx_scantime ON ScanRecords(ScanTime);索引是必须的查询历史记录时按条码或时间过滤没索引几万条就开始卡。// 插入记录的参数化写法防 SQL 注入也防特殊字符 public void SaveScanRecord(string scanCode, string station, string operatorName) { using (var conn new SQLiteConnection(Data Sourcescan.db;Version3;)) { conn.Open(); string sql INSERT INTO ScanRecords (ScanCode, StationName, OperatorName) VALUES (code, station, op); using (var cmd new SQLiteCommand(sql, conn)) { cmd.Parameters.AddWithValue(code, scanCode); cmd.Parameters.AddWithValue(station, station); cmd.Parameters.AddWithValue(op, operatorName); cmd.ExecuteNonQuery(); } } }参数化查询不只是防注入条码里如果有单引号或特殊符号拼字符串直接报错参数化能避开这个坑。4.3 DevExpress GridControl 绑定与导出查询结果展示用 DevExpress 的 GridControl绑定 DataTable 或 List 都行。导出功能用 GridControl 自带的 ExportToXlsx 或 ExportToCsv一行代码搞定。// 查询并绑定到 GridControl private void LoadScanHistory(DateTime from, DateTime to) { string sql SELECT * FROM ScanRecords WHERE ScanTime BETWEEN from AND to ORDER BY ScanTime DESC; using (var conn new SQLiteConnection(Data Sourcescan.db;Version3;)) { var adapter new SQLiteDataAdapter(sql, conn); adapter.SelectCommand.Parameters.AddWithValue(from, from); adapter.SelectCommand.Parameters.AddWithValue(to, to); var table new DataTable(); adapter.Fill(table); gridControl1.DataSource table; // 自动生成列 } } // 导出当前视图到 Excel private void ExportToExcel() { string path $ScanHistory_{DateTime.Now:yyyyMMddHHmmss}.xlsx; gridControl1.ExportToXlsx(path); // 导出后可以自动打开文件或提示路径 }GridControl 的 DataSource 赋 DataTable 后会自动根据列名生成列如果列顺序或显示名要定制在设计器里改 Columns 集合。导出路径建议带时间戳避免覆盖。5. 避坑与排查这套源码跑起来最容易翻车的五个地方5.1 现象编译报错“未能找到类型或命名空间名 DevExpress”原因DevExpress v23.1 没装或者装了但版本不对或者 NuGet 包没还原。解决确认安装的是 v23.1 且勾选了 WinForms 组件在 Visual Studio 里右键解决方案 → 还原 NuGet 包如果 HintPath 是绝对路径改成自己机器的路径或改用 NuGet 引用。5.2 现象扫码枪接上没反应串口打不开原因COM 口号写错、被其他程序占用、或者波特率不匹配。解决设备管理器里确认 COM 号用串口调试助手先单独测试扫码枪能不能出数据检查代码里 PortName 是不是硬编码了别人的 COM3改成实际口号。如果抛“拒绝访问”说明端口被占用关掉其他串口程序。5.3 现象扫码数据能收到但界面不更新或者直接崩原因DataReceived 在后台线程触发直接操作控件导致跨线程异常。解决所有 UI 更新用this.Invoke或BeginInvoke包起来。如果崩在Invoke之前检查窗体句柄是否已创建窗体构造阶段别开串口。5.4 现象数据写入 SQLite 报“database is locked”原因多个连接同时写或者上一个连接没释放。解决确保每次操作完using释放连接如果确实有多线程写入加锁或改用单例连接加队列。SQLite 的并发写能力有限扫码系统尽量单线程顺序写。5.5 现象DevExpress 控件运行时弹试用提示或水印原因没有 DevExpress 授权或者授权信息没正确注册。解决开发阶段可以用试用版跑正式部署前得购买授权并按照 DevExpress 的授权方式在代码或配置里注册。注意别把试用版直接交付到产线弹窗会打断操作员。6. 进阶技巧把扫码记录做成可追溯的本地日志与自动备份跑通基本流程后我一般会加两件事本地日志和自动备份。扫码系统最怕的是数据丢了说不清操作员说扫了、系统说没记录扯皮的时候日志就是后悔药。日志分两层一层是业务日志每次扫码成功或失败都写一条到文本文件格式带时间戳、条码、结果另一层是数据库备份每天定时把 SQLite 文件拷到备份目录保留最近 30 天。// 简单的业务日志写入按天分文件 public static void WriteLog(string message) { string dir Path.Combine(AppDomain.CurrentDomain.BaseDirectory, Logs); Directory.CreateDirectory(dir); string file Path.Combine(dir, $scan_{DateTime.Now:yyyyMMdd}.log); string line ${DateTime.Now:yyyy-MM-dd HH:mm:ss.fff} | {message}; File.AppendAllText(file, line Environment.NewLine, Encoding.UTF8); } // 数据库备份建议放在定时器或窗体关闭时 public static void BackupDatabase(string dbPath, string backupDir) { Directory.CreateDirectory(backupDir); string target Path.Combine(backupDir, $scan_{DateTime.Now:yyyyMMddHHmmss}.db); File.Copy(dbPath, target, overwrite: true); // 清理 30 天前的备份 foreach (var f in Directory.GetFiles(backupDir, scan_*.db)) { if (File.GetCreationTime(f) DateTime.Now.AddDays(-30)) File.Delete(f); } }日志写入用 AppendAllText 简单直接但高频扫码时频繁开文件句柄有性能损耗可以改成队列加后台线程批量写。备份用 File.Copy 在数据库没写入时是安全的SQLite 支持热备份但保险起见在业务空闲时做。验证方法扫十个码看日志文件是不是十条、数据库是不是十条、备份目录有没有生成文件。然后手动删掉数据库从备份恢复看数据能不能回来。这套流程走一遍心里就有底了。从那以后我每次拿到这类扫码源码都先把日志和备份加上再交付产线上扯皮的事少一大半。希望帮到你。本文还有配套的精品资源点击获取