<p>HTML5中不能用HTML注释写算法逻辑，因HTML是标记语言不执行代码；算法注释应写在JavaScript中，用//或/ /说明步骤、边界条件等，并确保与代码同步更新。</p>

HTML5里不能写算法注释

HTML 是标记语言，不执行逻辑，<!-- --> 注释只用于说明结构、占位或临时禁用标签，无法承载算法思路。真要记录算法逻辑，得把注释写在能运行代码的地方——比如 <script> 块里的 JavaScript，或外部 .js 文件中。

在 <script> 里用 JS 注释写算法思路

把算法步骤、边界条件、关键变量含义，用 // 或 /* */ 写在对应代码行附近。重点不是“写了注释”，而是让后续人（包括未来的你）一眼看懂“为什么这么算”。

• 用 // 注释单步意图，比如：// 检查 i 是否越界，避免数组访问错误
• 用 /* */ 包裹多行设计说明，比如输入约束、时间复杂度权衡、特殊 case 处理原因
• 避免注释和代码脱节：删了代码却忘了删注释，或注释写“取最大值”但实际是求最小值，比不写还危险

别把算法注释塞进 HTML 标签属性里

有人试过用 data-* 属性存注释，比如 <div data-algo="二分查找，注意右边界闭区间">。这看似“记录了”，但实际毫无用处：

Comprehensive Three.js 3D graphics reference

详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。

下载

• 这些字符串不会被任何工具解析为逻辑说明
• 调试时看不到，IDE 不提示，搜索 Ctrl+F 找不到上下文
• 和真实执行的代码完全隔离，改算法不改属性，注释就立刻失效

function binarySearch(arr, target) {
  let left = 0;
  let right = arr.length - 1;
  // 循环不变量：target 若存在，必在 [left, right] 闭区间内
  // 因此退出条件是 left > right，而非 left >= right
  while (left <= right) {
    const mid = Math.floor((left + right) / 2);
    if (arr[mid] === target) return mid;
    if (arr[mid] < target) {
      left = mid + 1; // 缩小左边界，mid 已排除
    } else {
      right = mid - 1; // 缩小右边界，mid 已排除
    }
  }
  return -1;
}

算法思路必须紧贴可执行代码，否则就是幻觉。HTML 注释只管“这是什么模块”，JS 注释才管“这个怎么算”。

立即学习“前端免费学习笔记（深入）”；