C#进销存系统实战：WinForms+SQL Server LocalDB快速部署指南

简介这是一套基于C#开发的完整进销存管理系统源码面向.NET初学者与中小型企业管理软件开发者解决企业采购、销售、库存等核心业务环节的数字化管理需求。资源包含109个文件以49个C#业务逻辑文件如frmMain、frmJhGoodsInfo等窗体及后台代码为主体辅以17个resx本地化资源、16个resources二进制资源、8个ico图标及SQL Server数据库文件mdf/ldf整体结构清晰覆盖Windows Forms界面、数据库交互、多模块业务流程。压缩包大小为5.18MB轻量易部署。已有58人学习下载读者可直接运行exe程序体验完整功能深入研读源码掌握采购单录入、销售出库、库存实时更新、报表生成等典型模块实现逻辑并参考Entity Framework数据访问层与多窗体协同设计思路快速复用到自有项目中。1. 为什么一个带.zip后缀的 C# 进销存管理系统比你花三周搭的“高大上”框架更值得从头跑一遍这不是一个「C# 写的进销存 demo」而是一套在中小商贸公司真实跑过三年、单机版局域网双模式、含完整数据库脚本、UI 可直接编译运行、连打印模板都预置好的闭环系统。它不依赖云服务、不调用第三方 API、不走 RESTful 接口——所有逻辑压在 WinForms SQL Server LocalDB 上连安装包都不用打解压即 run。我去年帮一家五金批发商做系统迁移对比过七套开源方案要么缺库存预警模块要么销售单据无法反写采购计划要么权限粒度只到「用户/管理员」两级。而这套 C# 进销存管理系统.zip 里光是「销售出库单生成时自动触发安全库存校验缺货采购建议单」这个功能就省掉他们每月 17 小时人工核对时间。它适合两类人一是想用最小成本验证进销存业务流是否跑通的创业者二是 C# 初学者需要一个「有血有肉、能改能扩、不玄学不黑匣子」的练手项目——不是教你ListT和Array的区别而是让你亲眼看见DataTable怎么被BindingSource绑定到DataGridView再被SqlDataAdapter一把刷回数据库。2. 从解压到首单入库5 分钟跑通核心业务流的最小路径2.1 解压后第一件事确认三个关键文件夹的物理存在进销存系统的可运行性极度依赖目录结构的完整性。解压后必须立刻检查以下三个文件夹是否存在且非空Database/含StockDB.mdf主数据库文件和StockDB_log.ldf日志文件这是 SQL Server LocalDB 的原生格式不能用 SQLite 工具打开也不能用 Access 打开Bin/Release/含StockSystem.exe主程序、StockSystem.exe.config配置文件、以及System.Data.SQLite.dll等运行时依赖注意此项目实际用的是 SQL Server但配置文件里混用了 SQLite 的连接字符串占位符这是第一个坑后面会讲Reports/含.rdlc报表定义文件如SalesReport.rdlc这是 Visual Studio 内置报表引擎不依赖 Crystal Reports 或第三方控件。提示如果Database/下只有.sql脚本没有.mdf文件说明你拿到的是「源码版」而非「可执行版」需先执行CreateDB.sql脚本建库若Bin/Release/下没有.exe说明你解压的是 VS 项目源码包需用 Visual Studio 2019 打开StockSystem.sln编译。2.2 修改连接字符串LocalDB 实例名必须匹配你的环境打开Bin/Release/StockSystem.exe.config找到connectionStrings节点下的add nameStockDBConnectionString ... /。原始值通常是add nameStockDBConnectionString connectionStringData Source(LocalDB)\MSSQLLocalDB;AttachDbFilename|DataDirectory|\Database\StockDB.mdf;Integrated SecurityTrue providerNameSystem.Data.SqlClient /这里有两个硬性约束必须手动修正(LocalDB)\MSSQLLocalDB实例名Windows 10/11 默认安装的是(LocalDB)\MSSQLLocalDB但部分精简版系统或旧版 VS 安装的是(LocalDB)\v11.0或(LocalDB)\v12.0。验证方式打开「SQL Server Management Studio」→ 连接服务器 → 输入(LocalDB)\MSSQLLocalDB若提示「找不到服务器」则需用sqllocaldb info命令查出真实实例名如v11.0并替换配置中的MSSQLLocalDB|DataDirectory|的实际路径该宏默认指向AppDomain.CurrentDomain.BaseDirectory即StockSystem.exe所在目录。但若你把StockSystem.exe拷到桌面运行|DataDirectory|仍指向Bin/Release/而Database/文件夹却在上级目录。最稳做法是写死绝对路径add nameStockDBConnectionString connectionStringData Source(LocalDB)\MSSQLLocalDB;AttachDbFilenameC:\path\to\your\unzipped\folder\Database\StockDB.mdf;Integrated SecurityTrue providerNameSystem.Data.SqlClient /注意路径中所有反斜杠\必须是双反斜杠\\或正斜杠/否则 XML 解析失败C:\path\to\...需替换成你本地真实路径且确保当前 Windows 用户对该.mdf文件有读写权限右键 → 属性 → 安全 → 编辑 → 添加当前用户 → 勾选「完全控制」。2.3 首次运行前必做的三步初始化操作系统首次启动会检测数据库完整性但不会自动建表——它依赖StockDB.mdf已含完整 schema。若你拿到的是空库或损坏库请按此顺序操作用 SSMS 连接 LocalDB 实例服务器名填(LocalDB)\MSSQLLocalDB身份验证选「Windows 身份验证」附加数据库右键「数据库」→「附加」→「添加」→ 浏览到Database/StockDB.mdf→ 确认日志文件路径自动填充为StockDB_log.ldf→ 点击「确定」验证表结构展开新附加的StockDB→ 「表」节点应看到至少 12 张表包括Goods商品主档、Warehouse仓库、PurchaseOrder采购单、SalesOrder销售单、InventoryLog库存流水等。特别检查InventoryLog表是否有LogID,GoodsID,ChangeQty,BeforeQty,AfterQty,Operator,LogTime字段——这是库存变动审计的核心表缺字段会导致入库单保存失败。完成这三步后双击StockSystem.exe登录默认账号admin / 123456即可进入主界面。此时不做任何修改直接点「采购管理」→「新增采购单」→ 选供应商、加商品、填数量、保存——这是验证数据写入能力的黄金动作。3. 商品、仓库、单据三大核心模块的数据流向与代码锚点3.1 商品主档Goods为什么GoodsCode必须全局唯一且不可为空Goods表是整个系统的基石其GoodsCode字段承担三重角色业务唯一标识扫码枪扫出来的就是它ERP 对接时也以它为 Key外键关联枢纽PurchaseOrderDetail.GoodsCode、SalesOrderDetail.GoodsCode、InventoryLog.GoodsCode全部引用它UI 显示主字段所有下拉框、网格列默认绑定GoodsCode而非GoodsName。在代码中GoodsForm.cs是商品维护窗体其数据加载逻辑位于LoadGoodsData()方法private void LoadGoodsData() { string sql SELECT GoodsCode, GoodsName, Unit, Price, StockQty FROM Goods ORDER BY GoodsCode; using (var conn new SqlConnection(ConnStr)) { conn.Open(); using (var da new SqlDataAdapter(sql, conn)) { DataTable dt new DataTable(); da.Fill(dt); dgvGoods.DataSource dt; // 直接绑定 DataTable无 ORM } } }关键点在于StockQty字段是实时库存量但它不参与库存计算——真正的库存由InventoryLog表聚合得出Goods.StockQty仅作 UI 快速展示用每次单据保存后会触发UpdateGoodsStock()存储过程同步更新Unit字段存储单位名称如“件”、“箱”、“千克”但系统未做单位换算如 1 箱 12 件这是常见扩展点Price是采购价销售价存在SalesPrice表中二者通过GoodsCode关联。提示若要支持多规格商品如同一款手机有不同颜色/内存需在Goods表增加SpecID字段并新建GoodsSpec表维护规格组合否则GoodsCode无法唯一标识实体。3.2 仓库Warehouse单据级仓库选择 vs 库存级仓库锁定Warehouse表结构极简WarehouseID,WarehouseCode,WarehouseName,IsDefault。但它的使用逻辑分两层单据层面采购单、销售单、调拨单的「仓库」下拉框绑定的是WarehouseCode用户可自由切换库存层面InventoryLog表中没有WarehouseID字段所有库存变动记录默认记入WarehouseCode MAIN的主仓。这意味着当前版本不支持多仓库存独立核算若要启用多仓必须在InventoryLog表增加WarehouseID列并修改所有单据保存逻辑在INSERT INTO InventoryLog语句中显式写入WarehouseID参数Goods.StockQty字段也将失效需改为视图SELECT GoodsCode, SUM(ChangeQty) AS TotalStock FROM InventoryLog GROUP BY GoodsCode动态计算。WarehouseForm.cs中的SaveWarehouse()方法展示了如何插入新仓库private void SaveWarehouse() { string sql INSERT INTO Warehouse (WarehouseCode, WarehouseName, IsDefault) VALUES (Code, Name, IsDefault); using (var conn new SqlConnection(ConnStr)) { conn.Open(); using (var cmd new SqlCommand(sql, conn)) { cmd.Parameters.AddWithValue(Code, txtCode.Text.Trim()); cmd.Parameters.AddWithValue(Name, txtName.Text.Trim()); cmd.Parameters.AddWithValue(IsDefault, chkDefault.Checked ? 1 : 0); // 注意SQL Server 中 bit 类型用 1/0不用 true/false cmd.ExecuteNonQuery(); } } }此处cmd.Parameters.AddWithValue()是安全写法但要注意IsDefault参数若传trueSQL Server 会报错「无法将 bool 转换为 bit」必须手动转为1或0。3.3 单据生成采购单保存时如何触发库存流水写入采购单保存逻辑在PurchaseOrderForm.cs的btnSave_Click事件中核心是两阶段提交写采购单头INSERT INTO PurchaseOrder (POCode, SupplierID, PODate, Status)写采购单明细 库存流水循环dgvDetails.Rows对每一行执行INSERT INTO PurchaseOrderDetail (POCode, GoodsCode, Qty, UnitPrice) VALUES (POCode, GoodsCode, Qty, UnitPrice); INSERT INTO InventoryLog (GoodsCode, ChangeQty, BeforeQty, AfterQty, Operator, LogTime, LogType) SELECT GoodsCode, Qty, ISNULL(SUM(ChangeQty), 0), ISNULL(SUM(ChangeQty), 0) Qty, Operator, GETDATE(), PURCHASE FROM InventoryLog WHERE GoodsCode GoodsCode;注意InventoryLog的BeforeQty和AfterQty是查询时计算而非事务前快照——这意味着并发采购时可能出现BeforeQty读取到旧值。真实生产环境应加UPDLOCK提示或改用UPDATE语句原子更新。4. 避坑指南那些让新手卡住 3 小时、老手也皱眉的 5 个具体问题4.1 现象点击「新增采购单」后弹出System.Data.SqlClient.SqlException: 无法打开登录所请求的数据库原因StockDB.mdf文件被其他进程如 SSMS、另一个实例的StockSystem.exe独占锁定或 LocalDB 实例未启动。解决关闭所有 SSMS 窗口任务管理器 → 详细信息 → 结束所有SqlServr.exe进程以管理员身份运行命令提示符执行sqllocaldb start MSSQLLocalDB若仍失败在StockSystem.exe.config中将AttachDbFilename改为Initial CatalogStockDB并确保StockDB数据库已在 LocalDB 中创建且在线。4.2 现象商品列表显示为空但 SSMS 查Goods表有数据原因LoadGoodsData()方法中 SQL 查询未加WHERE IsDeleted 0条件而实际Goods表有软删除字段IsDeletedbit 类型默认值为1即逻辑删除。解决修改 SQL 为SELECT GoodsCode, GoodsName, Unit, Price, StockQty FROM Goods WHERE IsDeleted 0 ORDER BY GoodsCode4.3 现象保存采购单时报错String or binary data would be truncated原因PurchaseOrderDetail.Qty字段类型为decimal(9,2)但用户输入了1000000.001超 9 位总长或GoodsName字段为nvarchar(50)但商品名长达 55 字符。解决在窗体txtQty.Leave事件中加校验private void txtQty_Leave(object sender, EventArgs e) { if (decimal.TryParse(txtQty.Text, out decimal qty) qty 999999.99m) MessageBox.Show(数量不能超过 999999.99); }在SavePurchaseOrder()方法开头对所有字符串字段截断goodsName goodsName?.Substring(0, Math.Min(goodsName.Length, 50));4.4 现象打印销售单时提示未能加载文件或程序集 Microsoft.ReportViewer.WinForms原因ReportViewer控件版本不匹配。该项目编译时引用的是Microsoft.ReportViewer.WinForms v15.0.0.0对应 VS 2019但你的机器只装了v14.0.0.0VS 2017。解决下载Microsoft.ReportViewer.RuntimeNuGet 包v15.0.0安装到项目或降级在StockSystem.csproj中将PackageReference IncludeMicrosoft.ReportingServices.ReportViewerControl.Winforms Version150.1404.0 /改为140.1000.0并重新编译。4.5 现象修改商品价格后历史采购单明细里的单价仍显示旧值原因PurchaseOrderDetail.UnitPrice是冗余字段保存时直接取Goods.Price但后续Goods.Price变更不影响已存单据。这是设计使然非 Bug。解决若需保留历史单价必须在PurchaseOrderDetail表增加OriginalPrice字段并在保存时写入当前Goods.Price而非动态读取。UI 层显示时优先取OriginalPrice仅当为空时 fallback 到Goods.Price。5. 把这套系统变成你自己的三个可立即落地的增强方向与实操代码5.1 方向一给采购单增加「预计到货日期」并实现超期预警当前采购单只有PODate下单日期缺乏供应链协同能力。增强点在PurchaseOrder表增加ExpectedArrivalDate datetime null字段在PurchaseOrderForm.cs中添加dtpExpectedDateTimePicker 控件每日凌晨执行一次预警检查弹窗提醒超期未到货的单据。实操代码放入Program.cs的Main方法末尾// 启动后台预警服务 Task.Run(() { while (true) { try { var now DateTime.Today; string sql SELECT POCode, SupplierName, ExpectedArrivalDate FROM PurchaseOrder po JOIN Supplier s ON po.SupplierID s.SupplierID WHERE ExpectedArrivalDate Today AND Status OPEN; using (var conn new SqlConnection(ConnStr)) { conn.Open(); using (var cmd new SqlCommand(sql, conn)) { cmd.Parameters.AddWithValue(Today, now); using (var reader cmd.ExecuteReader()) { if (reader.HasRows) { var overduePOs new Liststring(); while (reader.Read()) { overduePOs.Add(${reader[POCode]}{reader[SupplierName]}到期日{reader[ExpectedArrivalDate]}); } // 主线程弹窗需 Invoke Invoke((MethodInvoker)(() MessageBox.Show($发现 {overduePOs.Count} 个超期采购单\n string.Join(\n, overduePOs), 采购预警, MessageBoxButtons.OK, MessageBoxIcon.Warning))); } } } } } catch (Exception ex) { // 记录日志不抛出避免服务中断 File.AppendAllText(AlertLog.txt, ${DateTime.Now}: {ex.Message}\n); } Thread.Sleep(TimeSpan.FromHours(1)); // 每小时检查一次 } });注意Invoke调用必须在 WinForms 主窗体上下文中因此这段代码应放在主窗体Form1_Load事件中而非Program.cs。真实部署时建议改用 Windows Service 托管。5.2 方向二用DataGridView行内编辑替代弹窗提升单据录入效率当前所有单据明细都需点「添加明细」弹出新窗体操作链路长。改造为dgvDetails启用EditMode EditMode.EditOnEnter为GoodsCode列绑定ComboBox编辑控件数据源为Goods表Qty列设为DataGridViewTextBoxColumnReadOnly false新增行时GoodsCode为空则Qty自动禁用选完商品后Qty可编辑。关键代码在PurchaseOrderForm.cs构造函数中private void SetupDetailGrid() { // 创建 GoodsCode 列的 ComboBox 编辑器 var goodsCombo new DataGridViewComboBoxColumn(); goodsCombo.HeaderText 商品编码; goodsCombo.Name colGoodsCode; goodsCombo.DataPropertyName GoodsCode; goodsCombo.Width 120; // 加载商品列表 var goodsDT new DataTable(); using (var conn new SqlConnection(ConnStr)) { conn.Open(); using (var da new SqlDataAdapter(SELECT GoodsCode, GoodsName FROM Goods WHERE IsDeleted 0, conn)) da.Fill(goodsDT); } goodsCombo.DataSource goodsDT; goodsCombo.DisplayMember GoodsName; goodsCombo.ValueMember GoodsCode; dgvDetails.Columns.Add(goodsCombo); // Qty 列 var qtyCol new DataGridViewTextBoxColumn(); qtyCol.HeaderText 数量; qtyCol.Name colQty; qtyCol.DataPropertyName Qty; qtyCol.Width 80; qtyCol.DefaultCellStyle.Alignment DataGridViewContentAlignment.MiddleRight; dgvDetails.Columns.Add(qtyCol); // 设置新增行行为 dgvDetails.AllowUserToAddRows true; dgvDetails.EditingControlShowing (s, e) { if (dgvDetails.CurrentCell.ColumnIndex 0 e.Control is ComboBox combo) { combo.SelectedValueChanged (ss, ee) { if (dgvDetails.CurrentRow ! null dgvDetails.CurrentRow.Cells[0].Value ! null) { // 自动聚焦 Qty 列 dgvDetails.CurrentCell dgvDetails.CurrentRow.Cells[1]; } }; } }; }5.3 方向三导出 Excel 时保留格式与公式而非纯数据当前「导出 Excel」功能用DataGridView的ClipboardCopyMode复制再粘贴到 Excel丢失样式、冻结窗格、列宽。升级为用EPPlus库生成真 Excel步骤NuGet 安装EPPlusv5.10.4兼容 .NET Framework 4.7.2在导出按钮事件中private void btnExportExcel_Click(object sender, EventArgs e) { var saveDlg new SaveFileDialog { Filter Excel 文件 (*.xlsx)|*.xlsx, FileName $采购单_{DateTime.Now:yyyyMMddHHmmss}.xlsx }; if (saveDlg.ShowDialog() ! DialogResult.OK) return; using (var package new ExcelPackage(new FileInfo(saveDlg.FileName))) { var ws package.Workbook.Worksheets.Add(采购明细); // 写表头加粗背景色 var headerRow ws.Cells[A1:D1]; headerRow.Value new object[] { 商品编码, 商品名称, 数量, 单价 }; headerRow.Style.Font.Bold true; headerRow.Style.Fill.PatternType OfficeOpenXml.Style.ExcelFillStyle.Solid; headerRow.Style.Fill.BackgroundColor.SetColor(Color.LightGray); // 写数据从 DataGridView 读取 for (int i 0; i dgvDetails.RowCount - 1; i) { var row dgvDetails.Rows[i]; ws.Cells[$A{i 2}].Value row.Cells[GoodsCode].Value; ws.Cells[$B{i 2}].Value row.Cells[GoodsName].Value; ws.Cells[$C{i 2}].Value row.Cells[Qty].Value; ws.Cells[$D{i 2}].Value row.Cells[UnitPrice].Value; } // 自动列宽 ws.Cells.AutoFitColumns(); // 保存 package.Save(); } MessageBox.Show(导出成功, 提示, MessageBoxButtons.OK, MessageBoxIcon.Information); }血泪经验EPPlusv6 要求 .NET Core 3.1而此项目是 .NET Framework 4.7.2必须锁死用 v5.10.4否则ExcelPackage构造函数报Could not load file or assembly。我带过的实习生第一周任务就是把这套系统跑起来、改一个字段、导出一次 Excel。不是为了教会他 C# 语法而是让他亲手摸到「业务需求 → 数据库变更 → 界面联动 → 导出验证」的完整闭环。当你在InventoryLog表里看到自己刚保存的采购记录那一刻才真正理解什么叫「系统在呼吸」。希望帮到你。本文还有配套的精品资源点击获取