mysql如何注释SQL语句_mysql单行与多行注释规范

阿宇小哥_3543

阿宇小哥_3543

2026-03-04

493人浏览

原创

MySQL单行注释用--加空格,多行注释用/*...*/;--后必须有空格或换行,否则报错;/*...*/支持嵌套但慎用;注释在解析阶段被丢弃,一般不影响性能,但超长注释或含敏感信息可能引发问题。

mysql如何注释sql语句_mysql单行与多行注释规范

MySQL单行注释用-- (注意空格)

MySQL里最常用的单行注释是-- ,不是--——末尾那个空格不能少,否则会被当成语法错误或直接忽略。比如写成--SELECT * FROM users;,MySQL会报错ERROR 1064,因为解析器认不出这是注释。

常见错误现象:复制别人代码时漏掉空格,或者用 IDE 自动补全的//(那是 JavaScript/Java 的),结果语句执行失败。

  • -- 必须紧贴前面的SQL语句,中间可有空格,但后面必须跟空格或换行
  • 推荐写法:SELECT id FROM users; -- 获取用户ID
  • 不推荐写法:SELECT id FROM users;--获取用户ID(没空格,可能被忽略)
  • 在命令行客户端(mysql CLI)中,#也能单行注释,但不推荐——它在某些配置下不可用,且不兼容标准 SQL

MySQL多行注释用/* ... */,支持嵌套但慎用

/* ... */是标准 SQL 多行注释,MySQL 完全支持,还能嵌套(比如/* outer /* inner */ outer end */),但实际开发中几乎没人靠它做逻辑控制——容易误删、难调试,还可能干扰预处理语句。

使用场景主要是临时屏蔽大段 SQL,比如调试时把INSERT换成SELECT前先注释掉原语句;或者在存储过程里加说明性文字。

MySQL
MySQL

编写正确的MySQL查询,避免字符集、索引和锁方面的常见陷阱。

下载
  • 支持跨行:
    /* 这是<br>多行<br>注释 */
    (
    只是示意,实际换行即可)
  • 不能出现在字符串内:SELECT '/* 这不是注释 */' FROM dual; → 字符串内容原样输出
  • 如果嵌套使用,确保配对,否则会报ERROR 1064(解析到文件末尾都没找到结束符)
  • ORM 或连接池(如 mysql2、PyMySQL)一般不处理注释,但某些审计中间件会提取/*+ ... */这类 hint 注释,别乱加星号

注释影响性能吗?基本不影响,但别塞进高频查询

MySQL 在解析阶段就丢弃注释,不会进执行计划,所以EXPLAIN看不出来区别,也不占 buffer pool 内存。但有两个边界情况得留意:

  • 超长注释(几 MB)会让网络传输变慢,尤其用 PHP mysqli 或 JDBC 时,整条语句要先发到服务端再解析
  • 存储过程/函数定义里的注释会存进mysql.proc表,虽不执行,但备份恢复时体积略增
  • 某些代理(如 ProxySQL)或审计工具会扫描注释内容,含敏感信息(如/* password=xxx */)可能泄露

不同客户端对注释的处理差异

CLI、DBeaver、Navicat 等工具都支持标准注释,但行为略有不同。比如 MySQL Workbench 默认启用“执行当前语句”,光标在/*块里时可能选中整段而非单条语句;而 VS Code 的 SQL 插件有时会把--后紧跟字母识别为变量名(如--id被高亮成id变量)。

  • CLI 中,--注释必须独占一行或放语句末尾,不能出现在语句中间(如SELECT -- comment id FROM users会报错)
  • PHP mysqli::multi_query() 要求每条语句以分号结尾,--注释不能断开分号位置,否则只执行前半部分
  • Python 的 mysql-connector-python 对/* */内换行较敏感,若注释里有未转义的\r\n,可能被误判为语句分隔

注释本身很简单,但混在真实业务 SQL 里时,空格、换行、客户端适配这些细节,往往比语法本身更容易卡住人。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

mysql sql语句

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

2023.10.12

4723

8

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.27

971

4

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

2024.02.23

1229

5

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

2024.03.06

6721

10

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

2024.03.06

3443

4

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

2024.04.07

6700

11

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

2024.04.29

9261

6

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

2024.04.29

1250

5

sql中删除一列的命令是什么
sql中删除一列的命令是什么

在sql中,使用alter table语句可以删除一列,语法为:alter table table_name drop column column_name。想了解更多sql的相关内容,可以阅读本专题下面的文章。

2024.04.29

1092

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL vs MySQL
PostgreSQL vs MySQL

共1课时 | 193人学习