ctrl+/是navicat唯一可靠行注释快捷键，支持单/多/跨选区；--注释须带空格才可被ctrl+shift+/识别取消；/ /块注释需手动配对且禁用于存储过程逻辑块，否则引发语法错误。
navicat 的注释功能本身不提升理解力，真正起作用的是「人如何用它组织信息」——ctrl+/ 注释只是开关，关键在注释内容是否可读、可维护、可协作。
用 Ctrl+/ 注释前先想清楚谁会读这段 SQL
团队里有人只看执行结果，有人要改逻辑，有人负责上线审核。不同角色需要不同层级的注释：
- 给 DBA 看的：在
DELIMITER $$上方加一行说明「此存储过程每小时清理过期 session，影响sessions表」 - 给后端开发看的：在 JOIN 条件旁用
Ctrl+/注释掉旧写法，再补新逻辑，比如-- 旧：t.user_id = u.id → 新：t.user_id = COALESCE(u.id, 0) - 给新人看的：在复杂 CTE 开头写
-- 【用途】汇总近7天订单状态分布，用于 BI 看板刷新，别只写-- 汇总
别把 /* */ 块注释当万能胶水
/* */ 在 Navicat 编辑器里不会自动配对，也不高亮匹配，一漏写闭合就整段变灰，执行直接报错 You have an error in your SQL syntax。
- 跨语句使用风险极高：比如在
INSERT后紧跟/*，但忘了在UPDATE前闭合，后面所有语句全被吞 - MySQL 存储过程中禁用
/* */包裹逻辑块——它不认嵌套注释，只支持语句末尾的-- - 调试时优先用
Ctrl+/，确认逻辑无误后再手动补/* */文档化，且必须成对出现在同一语句内
团队协同注释的三个硬约束
没有统一约定，注释越多越混乱：
- 所有
--注释必须带空格：写成-- WHERE id > 1，不是--WHERE id > 1（后者会导致Ctrl+Shift+/失效） - 禁止在
DELIMITER、BEGIN、END行上用Ctrl+/，这些行若被注释，整个存储过程体无法创建 - 粘贴外部 SQL 后，先
Ctrl+F搜索--，检查是否混入了无空格或缩进异常的注释行，再批量取消
最常被忽略的一点：Navicat 不保存注释历史，也不做版本比对。你今天加的 -- 【2026-06-01】修复时间戳时区偏移，明天别人删掉重写，没人知道为什么改——所以注释里必须包含时间、责任人、变更依据（如 Jira ID 或 bug 编号），否则它只是装饰性文本。
