规则	说明
小写字母	`youlai_admin`
下划线分隔	不用驼峰
业务前缀	`youlai_`

表名命名

类型	前缀	示例
系统表	`sys_`	`sys_user`, `sys_role`
业务表	`biz_`	`biz_order`, `biz_product`
关联表	`rel_` 或主表前缀	`sys_user_role`, `rel_user_dept`
配置表	`cfg_`	`cfg_dict`, `cfg_config`
日志表	`log_`	`log_login`, `log_operation`

字段命名

类型	规范	示例
主键	`id`	`id`
外键	表名 + `_id`	`user_id`, `dept_id`
名称	`xxx_name`	`user_name`, `dept_name`
状态	`status`	`status`
类型	`xxx_type`	`menu_type`, `log_type`
时间	`xxx_time`	`create_time`, `login_time`
布尔	`is_xxx`	`is_deleted`, `is_enabled`
数量	`xxx_count`	`login_count`, `view_count`
排序	`sort` 或 `order_num`	`sort`

索引命名

类型	前缀	示例
主键	`pk_`	`pk_user`
唯一索引	`uk_`	`uk_username`
普通索引	`idx_`	`idx_dept_id`
组合索引	`idx_`	`idx_dept_status`
全文索引	`ft_`	`ft_content`

Part 2: 字段类型规范

主键

`id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '主键'

字符串类型

场景	类型	长度
用户名	VARCHAR	50
昵称	VARCHAR	50
密码（加密后）	VARCHAR	100
手机号	VARCHAR	20
邮箱	VARCHAR	100
URL	VARCHAR	500
标题	VARCHAR	200
简介	VARCHAR	500
详细描述	TEXT	-
JSON 数据	JSON	-

数值类型

场景	类型	说明
主键/ID	BIGINT	20 位
外键	BIGINT	关联主键类型
数量/计数	INT	-
金额（分）	BIGINT	避免浮点精度问题
排序号	INT	-
状态	TINYINT	0/1/2
类型	TINYINT	枚举值
百分比	DECIMAL(5,2)	0.00-100.00

时间类型

场景	类型	说明
创建时间	DATETIME	`create_time`
更新时间	DATETIME	`update_time`
日期	DATE	`birth_date`
时间戳	BIGINT	毫秒级

布尔类型

`is_deleted` TINYINT(1) NOT NULL DEFAULT 0 COMMENT '是否删除(0否 1是)'
`is_enabled` TINYINT(1) NOT NULL DEFAULT 1 COMMENT '是否启用(0否 1是)'

Part 3: 通用字段

每张表必备字段

`id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '主键',
`create_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
`update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
`create_by` BIGINT UNSIGNED DEFAULT NULL COMMENT '创建人',
`update_by` BIGINT UNSIGNED DEFAULT NULL COMMENT '更新人',
`deleted` TINYINT(1) NOT NULL DEFAULT 0 COMMENT '删除标志(0未删除 1已删除)',
PRIMARY KEY (`id`)

可选字段

`remark` VARCHAR(500) DEFAULT NULL COMMENT '备注',
`version` INT NOT NULL DEFAULT 0 COMMENT '乐观锁版本号',
`tenant_id` BIGINT UNSIGNED DEFAULT NULL COMMENT '租户ID',

Part 4: 索引规范

索引原则

原则	说明
最左前缀	组合索引按查询顺序建立
高选择性	选择区分度高的列
控制数量	单表索引不超过 5 个
组合优先	组合索引优于多个单列索引

必建索引

-- 主键索引
PRIMARY KEY (`id`)

-- 外键索引
INDEX `idx_dept_id` (`dept_id`)

-- 状态索引（常用于筛选）
INDEX `idx_status` (`status`)

-- 创建时间索引（常用于排序）
INDEX `idx_create_time` (`create_time`)

-- 唯一索引（业务唯一字段）
UNIQUE INDEX `uk_username` (`username`)

组合索引

-- 组合索引：部门 + 状态
INDEX `idx_dept_status` (`dept_id`, `status`)

-- 组合索引：用户 + 创建时间
INDEX `idx_user_time` (`user_id`, `create_time`)

索引避坑

避免	原因
`LIKE '%xxx%'`	前缀模糊不走索引
`OR` 条件	可能不走索引，改用 UNION
函数操作	`WHERE YEAR(create_time) = 2024` 不走索引
类型转换	字符串与数字比较会隐式转换
`NOT IN`	改用 `NOT EXISTS` 或 `LEFT JOIN ... IS NULL`

Part 5: 表设计规范

用户表示例

CREATE TABLE `sys_user` (
  `id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '主键',
  `username` VARCHAR(50) NOT NULL COMMENT '用户名',
  `password` VARCHAR(100) NOT NULL COMMENT '密码',
  `nickname` VARCHAR(50) NOT NULL COMMENT '昵称',
  `mobile` VARCHAR(20) DEFAULT NULL COMMENT '手机号',
  `email` VARCHAR(100) DEFAULT NULL COMMENT '邮箱',
  `gender` TINYINT NOT NULL DEFAULT 0 COMMENT '性别(0未知 1男 2女)',
  `avatar` VARCHAR(500) DEFAULT NULL COMMENT '头像URL',
  `status` TINYINT NOT NULL DEFAULT 1 COMMENT '状态(1正常 0禁用)',
  `dept_id` BIGINT UNSIGNED DEFAULT NULL COMMENT '部门ID',
  `create_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
  `create_by` BIGINT UNSIGNED DEFAULT NULL COMMENT '创建人',
  `update_by` BIGINT UNSIGNED DEFAULT NULL COMMENT '更新人',
  `deleted` TINYINT(1) NOT NULL DEFAULT 0 COMMENT '删除标志(0未删除 1已删除)',
  PRIMARY KEY (`id`),
  UNIQUE INDEX `uk_username` (`username`),
  INDEX `idx_dept_id` (`dept_id`),
  INDEX `idx_status` (`status`),
  INDEX `idx_create_time` (`create_time`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='用户表';

关联表示例

CREATE TABLE `sys_user_role` (
  `id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '主键',
  `user_id` BIGINT UNSIGNED NOT NULL COMMENT '用户ID',
  `role_id` BIGINT UNSIGNED NOT NULL COMMENT '角色ID',
  `create_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  PRIMARY KEY (`id`),
  UNIQUE INDEX `uk_user_role` (`user_id`, `role_id`),
  INDEX `idx_role_id` (`role_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='用户角色关联表';

Part 6: 字段默认值

字段类型	默认值	说明
字符串	`NULL` 或 `''`	非必填用 NULL
数值	`0`	-
布尔	`0` 或 `1`	根据业务
时间	`CURRENT_TIMESTAMP`	-
外键	`NULL`	非必填关联

NULL vs NOT NULL

场景	选择
必填字段	`NOT NULL`
可选字段	`NULL`
外键（非必填）	`NULL`
状态字段	`NOT NULL DEFAULT 1`

Part 7: 字符集与引擎

字符集

DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci

设置	说明
`utf8mb4`	支持 4 字节字符（emoji）
`utf8mb4_unicode_ci`	不区分大小写排序

存储引擎

ENGINE=InnoDB

引擎	适用场景
InnoDB	事务、外键、行锁
MyISAM	只读、全文索引（旧版）
Memory	临时表、缓存

Part 8: SQL 编写规范

SELECT

-- ✅ 指定字段
SELECT id, username, nickname FROM sys_user WHERE status = 1;

-- ❌ 避免 SELECT *
SELECT * FROM sys_user;

-- ✅ 分页查询
SELECT id, username FROM sys_user WHERE status = 1 LIMIT 0, 20;

-- ✅ 批量插入
INSERT INTO sys_user (username, nickname) VALUES ('user1', '用户1'), ('user2', '用户2');

UPDATE

-- ✅ 带 WHERE 条件
UPDATE sys_user SET nickname = '新昵称' WHERE id = 1;

-- ✅ 乐观锁
UPDATE sys_user SET nickname = '新昵称', version = version + 1 WHERE id = 1 AND version = 1;

-- ❌ 避免全表更新
UPDATE sys_user SET status = 0;

DELETE

-- ✅ 逻辑删除
UPDATE sys_user SET deleted = 1 WHERE id = 1;

-- ✅ 物理删除（慎用）
DELETE FROM sys_user_role WHERE user_id = 1;

Part 9: 性能优化

查询优化

优化点	说明
避免 `SELECT *`	只查需要的字段
避免 `LIKE '%xxx%'`	用 `LIKE 'xxx%'` 或全文索引
避免大 OFFSET	`LIMIT 10000, 20` 改用游标分页
避免 `COUNT(*)`	大表用缓存或估算
批量操作	批量插入/更新代替循环单条

表设计优化

优化点	说明
垂直拆分	大字段拆到扩展表
水平拆分	大表按规则分表
适当冗余	减少关联查询
归档历史	冷数据迁移

表名命名

字段命名

索引命名

Part 2: 字段类型规范

主键

字符串类型

数值类型

时间类型

布尔类型

Part 3: 通用字段

每张表必备字段

可选字段

Part 4: 索引规范

索引原则

必建索引

组合索引

索引避坑

Part 5: 表设计规范

用户表示例

关联表示例

Part 6: 字段默认值

NULL vs NOT NULL

Part 7: 字符集与引擎

字符集

存储引擎

Part 8: SQL 编写规范

SELECT

UPDATE

DELETE

Part 9: 性能优化

查询优化

表设计优化

Part 10: 设计检查清单

mysql-design

MySQL 数据库设计规范

触发条件

Part 1: 命名规范

库名命名

More from youlaitech/youlai-skills

thinkphp

uniapp

vue-admin

spring-boot

nestjs

gin