<p>HTML 中 code 标签仅用于标记内联代码字面量，不可用于记录重构过程；重构说明应使用 HTML 注释 <!-- -->，因其语义正确、可访问、不渲染且工具可识别。</p>
HTML 中没有 code 标签用于“记录重构过程”——它只是语义化标签，用来标记一段计算机源代码，和 Git 提交、注释日志、变更说明完全无关。别被名字误导了。
用 <code> 标签包裹真实代码片段
它的唯一合法用途是标记内联的、短小的代码字面量，比如函数名、HTML 属性、CSS 类名等。浏览器默认会用等宽字体渲染，但不会做语法高亮或缩进处理。
- 正确：描述某段逻辑时嵌入实际值 ——
<button onclick="handleClick()"中的handleClick是函数名，适合用<code> - 错误：把整块重构前/后的 HTML 结构塞进去，比如
<code><div class="old-layout">...</div></code> - 错误：当成日志容器写“2026-09-05 重构 header 结构”，这违反语义，也无任何工具能识别
重构记录该写在哪？不是 <code>，而是注释
真正承载重构说明、时间戳、原因、影响范围的地方，是 HTML 注释：<!-- -->。它不渲染、不执行，但开发者一眼可见，且可被构建工具提取（如文档生成器）。
- 模块级记录：在
<header>前加<!-- 【header】v2.1 | 2026-09-05 | 替换为语义化结构，移除 wrapper div --> - 行级标记：在关键改动行旁写
<!-- TODO: 后续需对接新 API 字段 user.profileImgUrl --> - 避免写在
<script>或<style>内部 —— 那里该用//或/* */
为什么不用 <code> 做重构日志？三个硬限制
即使强行用，也会立刻暴露问题：
立即学习“前端免费学习笔记（深入）”；
- 语义错误：W3C 规范明确定义
<code>表示「一段计算机代码」，不是「一段开发笔记」，校验工具（如 W3C Validator）会警告 - 可访问性破坏：屏幕阅读器会把
<code>内容读作「代码」，念出所有尖括号和引号，干扰理解 - 样式污染：默认
font-family: monospace和white-space: normal，导致长文本折行错乱，无法对齐常规段落
重构记录的核心是「人看懂、工具可识别、不干扰运行」——只有 <!-- --> 注释天然满足。别为了图省事把 <code> 当记事本用，那只会让下个接手的人多花三分钟猜你到底改了什么。
