DSMall 字段和索引怎么起名:比表前缀更影响日常开发

简介: DSMall数据库字段与索引命名规范:全库snake_case;统一语义(如`is_deleted`);主键用`id`、外键用`xxx_id`;状态分维度命名(`order_status`/`refund_status`);金额用`decimal`、积分用`int`;时间按场景选`*_at`或`*_time`;索引前缀`idx_`/`udx_`,名含字段;COMMENT须明确枚举值。

表名有 sys_ / tbl_ / trade_ 做导航之后,日常写代码接触最多的其实是字段和索引。


1. 总原则:名字是给「联表和搜索」用的

三条底线:

  1. 全库 snake_case,不用驼峰进 MySQL
  2. 同一概念全库一个词:删除就是 is_deleted,不要旁支 is_del
  3. 索引名能脱离 COMMENT 读懂用途

字符集统一 utf8mb4,引擎 InnoDB,和命名无关但和落地一致。


2. 字段类型 × 命名对照

2.1 主键与外键

`id` int NOT NULL AUTO_INCREMENT,
`user_id` int NOT NULL COMMENT '买家/会员ID',
`store_id` int NOT NULL COMMENT '店铺ID',
`goods_id` int NOT NULL,
`order_id` int NOT NULL
  • 主键固定 id
  • 外键固定 被引用表语义_id,不写 uid、sid 这种缩写(除非全库极早期已统一且不再扩散)

2.2 开关与布尔

`is_enabled` tinyint DEFAULT 1 COMMENT '0禁用 1启用',
`is_deleted` tinyint DEFAULT 0 COMMENT '0未删除 1已删除',
`is_distributor` tinyint DEFAULT 0 COMMENT '是否分销商',
`mobile_bind` tinyint DEFAULT 0 COMMENT '是否绑定手机'

习惯:

  • 是/否 → is_* 或语义清晰的 *_bind
  • 取值注释写清 0/1,避免「神奇数字」

2.3 业务状态

`goods_status` / `order_status` / `pay_status` / `refund_status`
`idcard_status` / `distributor_status` / `apply_status`

少用单独一个 status。
多状态并存时(订单上既有履约又有退款又有开票),每个维度一个字段名,例如订单上的 order_status + refund_status + invoice_status。

2.4 金额与计量

`balance` decimal(20,4) COMMENT '预存款可用',
`balance_in` / `balance_out` COMMENT '累计收入/支出',
`pay_amount` / `refund_amount` decimal(20,4),
`points` / `points_in` / `points_out` int
  • 钱:decimal,名字带业务角色(pay / refund / shipping…)
  • 积分、次数:int,累计进出可用 *_in / *_out 成对出现

2.5 时间

两类并存,但各有场景:

风格 场景 示例
*_at 通用创建更新、软删 create_at、update_at、deleted_at
*_time 流程节点、登录、支付完成 login_time、payment_time、pay_time

同一张表内保持可读即可;禁止同一含义两列(既有 create_at 又有 add_time 表示同一件事)。
订单这类流程表会有多个 *_time,属于业务节点,不算违规。


3. 会员表示例:一套字段里看出习惯

user 表是字典式样板——命名密度高,适合新人对照:

`username` varchar(32),
`nickname` varchar(32),
`mobile` varchar(11),
`mobile_bind` tinyint,
`inviter_id` int COMMENT '邀请人',
`balance` decimal(20,4),
`balance_in` decimal(20,4),
`balance_out` decimal(20,4),
`points` int,
`points_in` int,
`points_out` int,
`idcard_status` tinyint COMMENT '0默认 1审核中 2未通过 3已认证',
`is_enabled` tinyint,
`is_distributor` tinyint,
`distributor_status` tinyint,
`distributor_level_id` int

可以看出:

  • 认证、分销都是「前缀包一层」:idcard_*、distributor_*
  • 资产有余额、有积分,进出成对
  • 开关与状态分离:is_distributor vs distributor_status

4. 索引命名手册

4.1 前缀

前缀 用途
(主键) PRIMARY KEY (id)
udx_ 唯一索引
idx_ 普通 / 联合索引

4.2 怎么拼名字

UNIQUE KEY `udx_username` (`username`),
UNIQUE KEY `udx_order_sn` (`order_sn`),
KEY `idx_user_id` (`user_id`),
KEY `idx_store_id` (`store_id`),
KEY `idx_pay_status` (`pay_status`),
KEY `idx_create_at` (`create_at`),
KEY `idx_user_id_status` (`user_id`, `status`)  -- 联合:字段顺序写入名称

支付流水上常见:

UNIQUE KEY `udx_out_trade_no` (`out_trade_no`),
UNIQUE KEY `udx_trade_no` (`trade_no`),
KEY `idx_source_type` (`source_type`),
KEY `idx_source_id` (`source_id`),
KEY `idx_pay_channel` (`pay_channel`)

4.3 不建议

  • KEY a (store_id)
  • KEY index_1 (...)
  • 联合索引名叫 idx_status(看不出还有 user_id)

5. COMMENT 最低标准

能进枚举的字段,注释至少包含取值:

COMMENT '支付状态 0未支付 1已支付 2已关闭'
COMMENT '实名认证状态(0默认1审核中2未通过3已认证)'
COMMENT '支付渠道 alipay wechat'

名字负责检索,注释负责对齐前端字典 / 后端 Enum。
DSMall 多端(用户、店铺、骑手、技师)共用同一套库时,这比再写一份「字段说明 Excel」更抗丢失。


6. 和表前缀怎么配合(只留一张速查)

你在改什么 表大概在 字段注意
上架/库存/促销标 tbl_goods is_*_goods、goods_status、platform
下单履约售后 tbl_order* order_status、refund_*、*_time
渠道支付退款 trade_* out_trade_no、pay_status、source_*
会员资产认证 user balance_*、points_*、idcard_*
系统配置内容 sys_* config_key / 业务自己的 code

7. Review 时三句口头禅

  1. 这个字段换个表,名字还会产生歧义吗?
  2. 索引名能否直接告诉我查询条件?
  3. COMMENT 能否让前端不用再来问枚举?

都过了,字段和索引的命名就可以合并进主干。


表前缀解决「去哪个房间」,字段和索引解决「房间里东西怎么摆」。
后者才是每天 CRUD 的手感来源——DSMall 更愿意在手册里写细这一层。

相关文章
|
3月前
|
小程序 Java PHP
2026 开源商城排行榜!Java/PHP8 大项目对比,选错系统二开到崩溃
2026年开源商城系统实战选型指南:避坑关键在系统而非业务。本文按技术栈新旧、开源完整性、架构适配性及二开友好度,精选8大主流系统——VortMall(微服务首选)、Tigshop(功能全覆盖)、CRMEB(微信生态强)等,并附协议风险、流程闭环、部署成本等落地 checklist,助团队高效抄作业。
|
开发者 物联网 物联网安全
透视盒马:新零售操作系统的秘密
盒马是一个端到端,线上线下一体化的零售业务。在阿里CIO学院攻“疫”技术公益大咖说的第十六场直播中,盒马技术负责人何崚详细介绍了盒马产品技术在构建供给网络、销售网络、物流网络这三个核心命题时遇到的挑战和技术难点。
5960 2
|
9天前
|
存储 弹性计算 固态存储
阿里云服务器多少钱一年?轻量200M带宽最低38元一年、ECS云服务器99元一年、企业199元1年(续费同价)
2026年阿里云服务器最新报价:轻量应用服务器200M带宽,新用户38元/年起;ECS经济型实例99元/年(新老同享);企业级2核4G 5M带宽ECS仅199元/年,续费同价。支持包年包月、按量付费等多种计费方式。阿里云官方活动:https://t.aliyun.com/U/ESyhOk
|
14天前
|
供应链 JavaScript Java
2026 年 11 月|开源商城选型,开发团队的核心判断依据
本文为开发者选型指南,对比Tigshop、VortMall、Mall4j、CRMEB、ECShop五大开源商城系统,聚焦业务适配性、技术栈(Java/PHP/Vue)、模块扩展性与维护成本,强调实操验证比功能清单更重要。(239字)
163 0
|
1月前
|
移动开发 JavaScript Java
常见商城源码的技术栈和特点:前后端分离、营销玩法与本地生活端口
本文对比7款主流商城源码:DSShop(单店+外卖/家政)、ECShop(传统模板型)、CRMEB(强营销多端)、RuoYi-Mall(若依权限底座)、DSMall Pro(多商户+多端服务)、Mall4j(标准Java多端,AGPL协议)、VortMall(微服务架构)。涵盖技术栈分层、核心交易与活动能力、差异化定位,助选型决策。
504 0
|
移动开发 监控 小程序
java家政平台源码,家政上门清洁系统源码,数据多端互通,可直接搭建使用
一款基于Java+SpringBoot+Vue+UniApp开发的家政上门系统,支持小程序、APP、H5、公众号多端互通。涵盖用户端、技工端与管理后台,支持多城市、服务分类、在线预约、微信支付、抢单派单、技能认证、钱包提现等功能,源码开源,可直接部署使用。
1001 24
|
2月前
|
缓存 NoSQL 测试技术
商城外卖家政商品列表为什么能抗住反复刷:查缓存查库回写一次拆解
本文详解DSMall商品列表缓存优化实践:通过「条件序列化生成唯一Key」避免漏参、收紧数据库查询条件保障数据安全、TTL+业务Tag实现精准失效。一整套方案将高频读请求从DB卸载至KV,显著降低数据库压力,适用于商城、外卖、家政等多场景列表缓存。(239字)
124 0
|
3月前
|
人工智能 自然语言处理 API
阿里云百炼Token Plan:统一Credits计费,全栈AI能力订阅新选择
在AI开发与智能体应用快速普及的当下,开发者与企业面临两大核心痛点:一是多模型调用成本高、计费复杂,不同模型、不同能力需单独付费,成本核算与管控难度大;二是AI工具生态分散,主流编程与智能体工具需分别配置不同平台的API Key,切换繁琐、效率低下。阿里云百炼Token Plan正是为解决这些痛点而生,它以**统一Credits计量**为核心,整合百炼平台全栈AI能力,提供个人版与团队版双版本订阅服务,兼容主流AI编程与智能体工具,实现“一份订阅、全能力调用、成本可控、管理便捷”,成为个人开发者与企业团队使用AI能力的首选订阅方案。
488 1
|
3月前
|
JSON 自然语言处理 小程序
快递物流按次查询 API 接口教程:单号自动识别与全球物流轨迹跟踪
本教程介绍阿里云市场全球快递单号自动识别查询服务API,支持1500+国内外快递公司,提供单号自动识别、实时/异步轨迹查询、顺丰隐私号查询等功能,响应快(≈577ms)、SLA 100%、仅HTTP 200计费,含免费试用与多档套餐,适用于电商、ERP、小程序等场景。
559 0