code标签仅用于行内小段代码的语义标记,如函数名、属性值等;多行代码须用pre包裹code,且需转义html特殊字符以确保安全与可访问性。

code 标签不是用来“写代码块”的容器,而是语义化标记**一行内的一小段计算机代码**。把它当 pre 或 blockquote 用,会破坏语义、影响可访问性,也容易被屏幕阅读器误读。
什么时候该用 code 标签
只在行内需要强调某几个字符是“实际运行的代码片段”时使用,比如函数名、变量名、文件名、命令、CSS 属性名、HTML 属性值等。它必须嵌套在段落、列表项或标题等块级元素中,不能单独撑起结构。
- ✅ 正确:
<p>调用 <code>fetch()方法发起请求 - ✅ 正确:
<li>将 <code>class属性设为"btn-primary" - ❌ 错误:
<code>console.log("hello");(多行、无上下文,应改用pre+code组合) - ❌ 错误:
<code><div class="container"></div>(含标签,且未转义,会实际渲染div)
code 必须和 pre 配合才能显示多行代码
单用 code 会忽略换行与多余空格(HTML 默认空白折叠)。要保留缩进、换行、多行结构,必须外层套 pre —— 它负责保留空白符,code 负责声明语义。
正确写法是:<pre class="brush:php;toolbar:false;"><code>function hello() {<br> return "world";<br>}</code></pre>
注意:pre 不自带代码高亮或字体,需额外加 CSS(如 font-family: monospace),否则可能显示为默认衬线字体,削弱识别度。
常见错误:把 code 当格式工具用
很多教程直接用 code 包裹命令行输出、JSON 片段、甚至整段 HTML,却不转义尖括号——这会导致浏览器尝试解析其中的标签,轻则内容消失,重则 DOM 结构错乱。
- ❌ 危险写法:
<code>(浏览器会把当成真实标签处理) - ✅ 安全写法:
<code><html lang="zh-CN">(必须对和 <code>>做 HTML 实体转义) - ✅ 更省心方案:用
pre+code+ JavaScript 高亮库(如 Prism.js),自动转义并着色
最容易被忽略的一点:语义错误比样式难调试。code 写错位置,对视觉影响小,但会让屏幕阅读器把普通文字读成“代码”,影响残障用户理解;搜索引擎也可能降低该段落的内容可信度。别为了少敲两个标签牺牲语义精度。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











