在数据库开发场景中，SQL语句的可读性直接影响开发效率和代码维护成本，尤其是MySQL作为常用的关系型数据库，遵循统一的书写规范能让代码更易理解、更少出错。良好的SQL书写习惯不仅能让团队成员快速看懂逻辑，也能在后续排查性能问题、修改业务逻辑时节省大量时间。
一、基础格式规范
1. 关键字统一大小写
MySQL的关键字不区分大小写，但统一大小写能提升语句的辨识度，推荐所有SQL关键字使用大写，字段名、表名、自定义变量等使用小写或者下划线命名的小写组合，避免大小写混用的情况。
反例：
select id, user_name from t_user where age > 18 order by create_time desc;
正例：
SELECT id, user_name FROM t_user WHERE age > 18 ORDER BY create_time DESC;
2. 合理换行与缩进
短SQL语句可以写在一行，但涉及多表关联、子查询、聚合函数的复杂语句，需要按照逻辑层级换行缩进，让结构一目了然。通常每个子句单独占一行，子查询内部再额外缩进一层。
正例：
SELECT
u.id,
u.user_name,
COUNT(o.id) AS order_count
FROM t_user u
LEFT JOIN t_order o ON u.id = o.user_id
WHERE u.status = 1
GROUP BY u.id, u.user_name
HAVING order_count > 3
ORDER BY order_count DESC
LIMIT 10;
二、命名与注释规范
1. 表名与字段名命名规则
表名和字段名推荐使用小写字母加下划线的组合，避免使用拼音或者无意义的缩写，做到见名知意。表名尽量使用复数形式表示集合，字段名清晰表达其存储的内容，比如用户表命名为t_user，用户名字段命名为user_name，而不是un或者yhm。
2. 合理使用注释
对于复杂的业务逻辑或者特殊的查询条件，需要添加注释说明，避免后续维护时理解成本过高。MySQL支持单行注释-- 注释内容和多行注释/* 注释内容 */，注释要简洁准确，不要写冗余的描述。
示例：
-- 查询活跃用户的近30天订单数量，status=1表示用户状态正常
SELECT
u.id,
u.user_name,
COUNT(o.id) AS recent_order_count
FROM t_user u
LEFT JOIN t_order o ON u.id = o.user_id
AND o.create_time >= DATE_SUB(NOW(), INTERVAL 30 DAY) /* 只统计近30天的订单 */
WHERE u.status = 1
GROUP BY u.id, u.user_name;
三、复杂语句优化规范
1. 避免SELECT * 全字段查询
明确指定需要查询的字段，不仅可以减少数据传输量，也能避免表结构变更后字段顺序变化导致的逻辑错误。如果后续表新增字段，使用SELECT *可能会返回多余的字段，影响程序运行。
反例：
SELECT * FROM t_user WHERE age > 18;
正例：
SELECT id, user_name, age, create_time FROM t_user WHERE age > 18;
2. 拆分过长语句
如果一个SQL语句包含多层嵌套子查询，逻辑过于复杂，可以将其拆分成多个临时表或者使用CTE（公用表表达式）来分步实现，每一步的逻辑单独说明，降低整体理解难度。
使用CTE的示例：
-- 先筛选出近30天有订单的用户，再统计这些用户的订单总金额
WITH recent_order_user AS (
SELECT DISTINCT user_id FROM t_order
WHERE create_time >= DATE_SUB(NOW(), INTERVAL 30 DAY)
)
SELECT
u.id,
u.user_name,
SUM(o.amount) AS total_amount
FROM recent_order_user rou
JOIN t_user u ON rou.user_id = u.id
JOIN t_order o ON u.id = o.user_id
GROUP BY u.id, u.user_name;
四、其他实用规范
- 给表或者字段起别名时，别名要简洁且有意义，比如用户表别名用
u，订单表别名用o，避免使用a、b这类无意义的别名。 - 条件判断中，字段放在比较运算符的左边，常量或者变量放在右边，比如
WHERE age > 18而不是WHERE 18 < age，符合常规阅读习惯。 - 插入语句明确指定字段列表，避免表结构变更后插入数据出错，比如
INSERT INTO t_user (user_name, age) VALUES ('张三', 20)而不是省略字段列表的写法。
遵循以上MySQL的SQL书写规范，长期坚持就能写出可读性高、易维护的SQL语句，减少团队协作中的沟通成本，也能降低后续代码迭代的风险。