如何在SQL框输入多行注释_/**/与--注释符标准用法

夏晨酱_2123

夏晨酱_2123

2026-06-22

903人浏览

原创

sql多行注释必须用/ /成对出现且不可嵌套,漏写/会导致后续语句被误注释;注释内不能含/(即使引号包裹),需注意数据库兼容性差异及空格要求。

sql多行注释 /* */ 怎么写才不报错

多行注释必须成对出现,且不能嵌套。常见错误是漏掉结尾的 */,导致后续所有 sql 被当成注释,执行时直接报语法错误或返回空结果。

使用场景:临时屏蔽大段查询、在复杂 CREATE VIEW 或存储过程中加说明、调试时注释掉中间逻辑。

  • /* 和 */ 必须在同一语句内(哪怕跨行),但不能跨多个独立语句——比如在 MySQL 客户端中用分号分隔的两条语句,第二条不会“继承”第一条的注释状态
  • 注释内容里不能出现 */,哪怕它被引号包裹也不行(例如 'abc */ def' 会提前结束注释)
  • PostgreSQL 和 SQL Server 支持 /* */,但 SQLite 默认不支持(需编译时开启 ENABLE_COMMENT)

示例(安全):

SELECT name, age
FROM users
/* 这里是多行注释
   可以换行,但不能有 */
WHERE active = 1;

-- 单行注释为什么有时“失效”

-- 后面必须紧跟一个空格或制表符(部分数据库如 MySQL 8.0+ 允许紧贴,但 PostgreSQL、SQL Server 严格要求空格),否则会被当作操作符或标识符的一部分,引发解析错误。

常见错误现象:--WHERE id=1 不生效,查询仍带条件;或者报错 ERROR: syntax error at or near "--"。

  • -- 只注释到本行末尾,换行后自动结束,不延续
  • 某些客户端(如 DBeaver 的 SQL 编辑器)支持用 -- 注释多行,但这是编辑器行为,不是 SQL 标准——实际发给数据库的仍是多条独立语句,每行都得带 --
  • Oracle 中 -- 和 /* */ 都支持;MySQL 5.7+ 对 -- 的空格要求已放宽,但为兼容旧版本,仍建议统一加空格

示例(推荐写法):

LobeHub
LobeHub

LobeHub是一款开源 AI 平台与多模型聊天、Agent 管理工具。

下载
SELECT * FROM orders;
-- 这行被忽略
SELECT COUNT(*) FROM orders; -- 这个注释也只到分号前

混合使用 /* */ 和 -- 时的坑

二者可以共存,但顺序和位置容易引发歧义。最典型的是在 /* */ 内部写 --,它不会起作用——因为整个区域已被识别为块注释,-- 就只是普通字符。

反过来,在 -- 行里写 /* 也不会开启多行注释,因为单行注释优先级更高。

  • 不要试图用 -- 去“关闭”一个 /*,这会导致语法错误(/* ... -- */ 中的 -- 无效,*/ 才是唯一出口)
  • 嵌套注释(/* /* inner */ outer */)在所有主流数据库中都不合法,会报错或截断
  • 如果用程序拼接 SQL(比如 Python 的 f-string),注意字符串里混入 /* 或 -- 可能意外触发注释,建议先转义或改用参数化查询

不同数据库对注释的兼容性差异

标准 SQL-92 规定只支持 --,/* */ 是后来扩展的,所以老系统或轻量数据库可能只认其一。

  • MySQL:两者都支持,-- 要求空格,/* */ 可用于提示(如 /*+ USE_INDEX(users) */)
  • PostgreSQL:严格遵循空格规则,-- 后无空格会报错;/* */ 支持跨函数体,但在 DO $$ ... $$ 块内需注意引号匹配
  • SQL Server:支持两者,但 Management Studio 的“注释/取消注释”快捷键默认只处理 --,容易让人误以为 /* */ 不被支持
  • SQLite:默认仅支持 --;启用 ENABLE_COMMENT 后才支持 /* */,但多数嵌入式部署没开

真正麻烦的不是语法本身,而是你写的注释在另一个环境里被当成了代码——比如本地用 PostgreSQL 测试正常,上线到 MySQL 时发现某处少了个空格,整条语句就静默失效了。

相关文章

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

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

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系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

4063

8

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

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

2023.10.27

871

4

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

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

2024.02.23

1049

5

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

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

2024.03.06

5941

10

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

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

2024.03.06

2843

4

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

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

2024.04.07

5920

11

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

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

2024.04.29

7881

6

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

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

2024.04.29

1070

5

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

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

2024.04.29

932

5

热门下载

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

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.6万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 133.4万人学习