Go库存管理系统用Item和Inventory结构体建模,map实现O(1)查找,封装AddItem、UpdateStock等方法确保数据一致性与边界检查,支持JSON文件原子化持久化及命令行交互。
在 Go 语言中构建简易库存管理系统,核心是用结构体建模商品、用 map 或切片管理集合、配合增删改查逻辑实现基础库存控制。不需要框架,纯标准库即可完成,重点在于数据一致性与操作边界检查。
定义商品与库存结构体
用结构体清晰表达商品属性和库存状态,避免裸用 map[string]interface{}:
- Item 表示单个商品:含 ID(唯一标识)、名称、当前库存数量、最低安全库存(可选)
-
Inventory 作为管理器:内部用
map[string]*Item实现 O(1) 查找,同时封装所有业务方法
示例:
type Item struct{ ID string `json:"id"` Name string `json:"name"` Stock int `json:"stock"` MinStock int `json:"min_stock,omitempty"` } type Inventory struct { items map[string]*Item }
实现基础库存操作方法
所有修改都通过 Inventory 的方法进行,确保逻辑集中、便于校验:
- AddItem:插入新商品,若 ID 已存在则返回错误
- UpdateStock:按 ID 修改库存,支持正数(入库)或负数(出库),自动检查是否超卖(如 stock + delta
- GetItem:安全获取,ID 不存在时返回 nil 或 error
- ListLowStock:遍历筛选低于 MinStock 的商品,用于补货提醒
关键细节:出库前必须判断 item.Stock + delta ,避免负库存;更新后建议返回更新后的 Item 指针,方便链式调用或日志记录。
用 JSON 文件持久化库存数据
不依赖数据库时,用本地 JSON 文件保存状态,启动时加载、变更后写回:
- 用
json.MarshalIndent写入可读格式,便于人工核对 - 写入前先写到临时文件(如
inventory.json.tmp),再原子重命名,防止写断导致数据损坏 - 加载失败(文件不存在或解析错误)时,应初始化空 inventory 并记录 warn 日志,而非 panic
示例保存逻辑片段:
func (inv *Inventory) SaveToFile(filename string) error {
data, _ := json.MarshalIndent(inv.items, "", " ")
tmp := filename + ".tmp"
if err := os.WriteFile(tmp, data, 0644); err != nil {
return err
}
return os.Rename(tmp, filename)
}
添加简单命令行交互(可选但实用)
用 flag 或 fmt.Scanln 快速验证逻辑,例如:
go run main.go add --id=SKU001 --name="无线耳机" --stock=50go run main.go sell --id=SKU001 --qty=3-
go run main.go list输出当前全部商品及库存
无需 Web 界面也能完成日常维护,适合小团队或嵌入设备场景。后续如需扩展,可将 CLI 替换为 HTTP API(用 net/http),结构体与核心逻辑完全复用。

{
ID string `json:"id"`
Name string `json:"name"`
Stock int `json:"stock"`
MinStock int `json:"min_stock,omitempty"`
}
type Inventory struct {
items map[string]*Item
}






