MySQL 註釋語法全解：三種風格與版本特性

MySQL SQL 註釋三種風格、特殊語法與版本演進

良好的註釋是可維護 SQL 的基石。MySQL 支持三種註釋風格，並隨版本引入特有擴展。

三種標準註釋風格

版本特性演進

• MySQL 3.23：引入 /*! ... */ **版本專用註釋**。MySQL 解析器會執行其中的 SQL，其他數據庫視為普通註釋忽略。
  示例：INSERT /*! DELAYED */ INTO t VALUES(1); → MySQL 執行 INSERT DELAYED，其他庫執行普通 INSERT。
• MySQL 3.23.3：支持 -- （雙減號+空格）作為單行註釋，兼容標準 SQL。注意：必須有空格，否則 5--7 會被誤判為註釋開始。

最佳實踐建議

1. **文件頭/區塊說明**用 C 風格 /* ... */，便於多行與工具提取。
2. **行尾說明**用 #（MySQL 慣例）或 -- （標準兼容）。
3. **跨庫兼容 SQL** 用 /*! MySQL專用語法 */ 封裝 DELAYED、HIGH_PRIORITY、STRAIGHT_JOIN 等 Hint。
4. **避免**無空格 --，防止表達式誤解析。
5. 生產環境部署腳本建議**保留註釋**，便於審計與應急排查。

工具支持

• mysqldump 導出默認包含 /*!40101 SET NAMES utf8 */ 等版本註釋。
• 大多數 GUI 工具（Navicat、DBeaver、Workbench）語法高亮支持三種風格。