MySQL 注释

在 MySQL 中，注释可以通过不同的方式添加到 SQL 查询中，主要有两种类型的注释：单行注释和多行注释。

单行注释：在 MySQL 中，单行注释以 -- 开始，并在该行的末尾终止。可以在任何 SQL 语句中使用单行注释。

示例：

SELECT * FROM students WHERE student_name = 'Jerry'; -- This is a single line comment

多行注释：MySQL 支持 C 风格的多行注释，以 /* 开始，以 */ 结束。多行注释可以跨越多行，并可以包含在任何 SQL 语句中。

示例：

/* This is a
   multi-line
   comment */
SELECT * FROM students WHERE student_name = 'Jerry';

使用井号(#)的单行注释：在MySQL命令行客户端中，可以使用#进行单行注释，类似于--。但在SQL语句中通常不推荐使用，因为#在某些上下文中可能被解释为配置指令。例如：

SELECT * FROM students; # 选择表中的所有记录

隐藏注释：使用/*!*/，MySQL会忽略这对注释标记之间的所有内容，即使它们在字符串或SQL语句中。这可以用于编写兼容多个MySQL版本的SQL语句。例如：

SELECT * FROM students /*! WHERE student_name = 'value' */;

条件注释：使用/*![version]*/，可以根据MySQL的版本号启用或禁用注释之间的代码。例如：

/*!50705 CREATE TABLE ... */ /* MySQL 8.0及以上版本 */
/*!50704 CREATE TABLE ... */ /* MySQL 5.7版本 */

文件注释：在存储的程序（如存储过程、函数、触发器）中，可以使用多行注释来描述程序的功能和用法。

正确使用注释可以使你的代码更加清晰易懂，同时也便于团队协作和代码维护。在使用注释时，应该简洁明了地表达代码的意图，避免冗余或误导性的注释。