很多同学写 SQL 的时候都熟悉#、--、/* */这几种普通注释。普通注释的特点很简单数据库解析时直接忽略里面的内容不会执行。但 MySQL 里有一类特殊注释在 MySQL 环境下注释内部的 SQL 会被执行其他数据库Oracle、PostgreSQL会当成普通注释直接跳过这就是MySQL 条件注释也常被叫做版本注释、可执行注释。一句话总结条件注释是 MySQL 提供的用来做跨数据库、跨版本 SQL 兼容的语法。一、基础语法/*! 这里写MySQL才会执行的SQL语句 */格式/*!开头*/结尾。MySQL会把/*!和*/中间的内容当做正常SQL执行其他数据库识别为普通多行注释直接忽略不会报错带版本号的条件注释最常用还可以在!后面加上版本号代表只有MySQL版本大于等于指定版本时才执行内部SQL/*!40101 SET NAMES utf8mb4 */;解读40101 4.1.01 版本MySQL 4.1.01 时执行SET NAMES utf8mb4版本低于该值 或者 非MySQL数据库当作注释忽略版本号规则主版本*10000 次版本*100 修订号示例8.0.26 → 800265.7.36 → 50736二、简单示例演示示例1基础条件注释-- 普通SQLSELECT1;/*! SELECT 2; */在MySQL执行会返回两个结果集1和2如果放到PostgreSQL执行只会执行SELECT 1SELECT 2被当成注释跳过。示例2版本控制仅高版本执行/*!80000 CREATE TABLE IF NOT EXISTS test_v8(id int) */;含义MySQL版本 ≥8.0.00 才会创建这张表5.7及更早版本不执行。我们经常导出mysqldump备份文件时里面大量出现这种语法这也是条件注释最典型的使用场景。打开dump文件就能看到大量/*!40xxx ... */。三、典型使用场景mysqldump导出备份mysqldump 默认大量使用条件注释。导出的SQL脚本可以在不同版本MySQL导入同时拿到其他数据库也不会因为MySQL特有语法报错。比如设置字符集、关闭外键检查等语句。/*!40101 SET OLD_CHARACTER_SET_CLIENTCHARACTER_SET_CLIENT */;/*!40014 SET OLD_UNIQUE_CHECKSUNIQUE_CHECKS, UNIQUE_CHECKS0 */;跨数据库兼容脚本一份SQL脚本同时兼容MySQL和其他数据库。特有语法写在条件注释里。例如只有MySQL支持的LIMIT其他数据库不支持就可以这样写SELECT*FROMuser/*! LIMIT 10 */;在PostgreSQL执行不会识别LIMIT不会执行这部分MySQL会正常执行limit。版本平滑适配新特性只在高版本MySQL启用低版本跳过。比如MySQL8.0支持的窗口函数、新的排序规则用版本条件注释包裹一份脚本兼容5.7和8.0。四、容易踩的坑注释内部语法错误依然会报错条件注释不是“屏蔽错误”MySQL满足版本条件后会直接解析里面的SQL。如果里面SQL写错一样抛出异常。/*!80000 SELEC 1 */;-- 拼写错误8.0环境直接报语法错误不要和普通多行注释混淆/* 内容 */所有数据库都是注释永远不执行。/*! 内容 */MySQL会执行其他库忽略。差别就在于那个感叹号。版本号写错逻辑完全反转版本号是大于等于才执行。如果你写/*!50700 ... */在MySQL8.0环境依旧会执行8000050700。不适合业务代码大量滥用条件注释适合迁移脚本、备份脚本。业务系统里SQL尽量不要大量依赖这个语法可读性差维护成本高。ORM框架一般不会推荐大量使用。五、补充反向理解很多人第一次看到mysqldump里面的/*!40000 DROP TABLE IF EXISTS ... */很疑惑以为是注释。其实这是MySQL专门设计的兼容语法为了让一份SQL脚本具备多环境兼容性是MySQL生态里很经典的设计。小结MySQL条件注释/*! [版本] sql */核心能力一句话一份SQL在MySQL中可选择性执行内部语句其它数据库自动忽略这段代码用于版本适配、跨库脚本兼容。它不是普通注释是MySQL独有的编译期条件执行语法最常见于mysqldump导出文件。日常业务SQL尽量少用但是做数据库迁移、脚本分发的时候这个特性就非常好用。