ModernWMS 仓库管理教程：部署后跑通一单入库与出库
【免费下载链接】ModernWMSThe open source simple and complete warehouse management system is derived from our many years of experience in implementing erp projects. We stripped the original commercial system wms function and opened it up for free, hoping to help the majority of small and medium-sized enterprises. At present, the system supports cross-platform。项目地址: https://gitcode.com/GitHub_Trending/mo/ModernWMS
ModernWMS 是一个开源仓库管理系统（WMS），作者从多年 ERP 实施经验沉淀的商业系统里剥离出核心 WMS 能力，免费开放给中小企业使用，支持跨平台部署。它覆盖从到货通知、验货分拣、上架，到拣货、称重、发货的完整链路。读完这篇仓库管理教程，你会在本地把 ModernWMS 跑起来，并亲手走通一单货进仓和出仓的完整流程。
ModernWMS 部署三步：环境、后端、前端
先装好两样东西：.NET SDK（版本以项目要求为准）和 Node.js。然后在仓库根目录依次执行：
git clone https://gitcode.com/GitHub_Trending/mo/ModernWMS启动后端，一条命令即可：
dotnet run --project backend/ModernWMS再开一个终端，安装依赖并启动前端：
cd frontend yarn install yarn dev如果提示端口被占用，改一下对应配置文件里的端口再重启即可。两个服务都起来后，浏览器打开前端地址就能登录系统。
登录后你会看到主界面：左侧是按功能划分的导航栏，右侧是各模块的操作区，下面按业务场景逐个走一遍。
收货流程：一单入库怎么走上架
入库不是"填一张单子"，而是一条流水线。ModernWMS 的收货管理模块把这条流水线拆成了清晰的标签页，一单货会按顺序流过这些环节：
- 到货通知：供应商发货前先录入通知单，仓库提前知道要收什么、收多少。
- 待收货：车辆到场后在对应标签页确认收货，货物正式进入仓库视野。
- 待验货：核对实收数量与质量，有问题在这里拦截，避免坏货流入库存。
- 待分拣：按规则把这一单货拆开归类，为上架做准备。
- 待上架：给每批货指定货位，确认后库存正式增加。
- 收货明细：所有历史收货记录都在这一页，随时可查可对账。
实际操作时，你只需要跟着标签页从前往后做：前一个环节完成，单据自动出现在下一个标签页。想复盘哪天的收货情况，去收货明细里按单号或日期筛一遍就行。
发货流程：INVOICE 到 PICKED 的状态含义
出库这一侧，ModernWMS 用状态标签追踪每张发货单走到哪一步。三个关键状态在流程中的位置如下：
| 状态 | 所处环节 | 含义 |
|---|---|---|
| INVOICE | 订单创建后 | 发票处理阶段，单据刚进入发货队列 |
| PRE SHIPMENT | 出库前 | 发货前准备，含拣货任务分配等前置动作 |
| PICKED | 作业中后段 | 拣货已完成，等待称重、打包和出库确认 |
除这三个外，系统还会展示其他状态标签，逐单标出货物当前环节。界面上同一张发货单还聚合了客户信息、货物重量体积等关键字段，不用切页面就能判断这张单卡在哪个步骤、该谁去处理。
界面地图：左侧菜单各管什么
第一次进来容易迷路，对照下面这张表就能建立整体认知：
| 左侧菜单 | 能干什么 |
|---|---|
| 基础设置 | 维护仓库、库区货位、商品、供应商、客户、角色等基础数据 |
| 收货管理 | 走通到货通知到上架的整个入库流程 |
| 库存管理 | 实时查看库存与货位分布，监控库存状态 |
| 仓内作业 | 处理移库、调整、冻结、盘点等仓内操作 |
| 发货管理 | 控制从订单到出库配送的整个出库流程 |
想改配置去基础设置，想动库存去仓内作业，想进出库就分别走收货和发货管理，路径很短。
三个效率动作：批量导入、搜索、权限
- Excel 批量导入：供应商、客户、仓库等基础数据都支持 Excel 导入，第一次初始化数据时用它，能省掉大量手工录入。
- 搜索与筛选：各列表页都提供搜索组和筛选条件，定位某张订单、某个商品或某个客户时，先想筛选条件而不是翻页。
- 角色权限：通过角色菜单管理给不同岗位配菜单和操作权限，比如库管员只给仓内作业和收货，避免无关人员看到不该动的数据。
卡住了这样查：三个高频故障的排查顺序
启动失败
- 确认 .NET SDK 和 Node.js 已安装，版本与项目要求匹配。
- 看终端报错，若是端口被占用，修改后端
appsettings.json或前端vite.config.ts中的端口配置后重启。
数据库连不上
- 检查数据库服务本身是否在运行。
- 核对连接字符串配置是否正确。
- 配置改完后重启后端再试。
页面显示异常
- 确认前端服务是否编译成功、无报错。
- 清一次浏览器缓存后刷新。
- 确认后端接口是否正常响应。
更多背景信息可以看项目自带的 README.md，前后端代码分别在 backend/ 和 frontend/ 下。
三天上手路线：从部署到两单实战
- 第 1 天：完成 ModernWMS 部署，在基础设置里建好仓库、库区和货位，用 Excel 导入一批供应商与客户数据。
- 第 2 天：录一张到货通知，把这单货从待收货一直做到待上架，再去收货明细里核对一遍结果。
- 第 3 天：创建一张发货单，观察它从 INVOICE 到 PRE SHIPMENT 再到 PICKED 的状态流转；最后建两个角色，分别只开放收货和发货菜单，用自己的账号各登录验证一次。
做完这三步，你已经完整摸过 ModernWMS 的进库、出库和权限三条主线，接下来按同样方式把仓内作业和统计模块逐个练过即可。
【免费下载链接】ModernWMSThe open source simple and complete warehouse management system is derived from our many years of experience in implementing erp projects. We stripped the original commercial system wms function and opened it up for free, hoping to help the majority of small and medium-sized enterprises. At present, the system supports cross-platform。项目地址: https://gitcode.com/GitHub_Trending/mo/ModernWMS
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
