编程注释规范：单行用//，多行用/.../；单行适合简短说明或临时禁用代码，多行用于复杂逻辑或函数说明；Python、HTML、SQL等有各自语法；注释应解释“为什么”，并随代码及时更新。
单行注释用 // 开头，多行注释用 /* ... */ 包裹，这是大多数编程语言（如 JavaScript、Java、C/C++、TypeScript 等）的通用规范。
单行注释：简洁说明当前行或上一行代码
适合简短说明、临时禁用某行代码、标注小功能点。
- 写在代码上方或同行末尾，但保持可读性；同行末尾时，// 前至少留一个空格
- 避免写过长句子，超过 80 字建议拆成多行或改用多行注释
- 不要嵌套单行注释（虽然语法允许，但易出错且不清晰）
// 计算用户登录失败次数
let failCount = getUserFailures(userId); // 仅对当前行补充说明
多行注释：解释复杂逻辑、函数用途或大段临时屏蔽
适用于函数说明、算法描述、版权信息、临时注释掉多行代码等场景。
- 开头用 /*，结尾用 */，中间每行无需额外符号，但常用 * 对齐提升可读性
- 禁止嵌套多行注释（/* /* ... */ */ 会报错），需改用多个单行注释替代
- 文档类注释（如 JSDoc）虽也用 /** ... */，但它属于扩展语法，不是基础多行注释
/*
* 验证邮箱格式是否合法
* 支持常见域名后缀，不校验 DNS 存在性
*/
function isValidEmail(str) { ... }
注意不同语言的细微差异
多数主流语言一致，但仍有例外：
- Python 使用 # 表示单行注释，无原生多行注释语法（用三引号字符串模拟，但非真注释）
- HTML 使用 ，不支持 // 或 /* */
- SQL 中 -- 是单行注释，/* ... */ 是多行注释（部分方言如 MySQL 支持）
良好习惯：注释要“说人话”，更要随代码更新
注释不是装饰，而是协作和维护的关键线索。
- 写注释前先想清楚：是解释“做什么”，还是“为什么这么做”？后者更有价值
- 代码重构后，务必同步检查并更新相关注释，过时注释比没注释更危险
- 避免无意义注释，例如 // i++ 或 // 返回 true
