code标签仅用于段落内短内容,如函数名、命令等,不换行不保留缩进;多行代码须用pre包裹,且需转义

单行代码用 code,多行代码必须套 pre;不转义 、<code>>、& 会直接破坏页面结构。
什么时候只用 code 标签
仅适用于嵌在段落里的短内容,比如函数名、命令、变量或属性名。它不换行、不保留缩进,浏览器会把所有空格和换行压成一个空格——这正是设计行为,不是 bug。
- ✅ 正确:
fetch()、useState、npm install、/src/index.js - ❌ 错误:
if (x (含未转义的 <code>,会被解析为标签) - ❌ 错误:
function hello() { console.log('hi'); }(多行+缩进,渲染后全塌成一行) - 别给
code加white-space: pre:会导致长命令横向溢出,且与周围文本基线错位
多行代码必须用 pre + code 嵌套
pre 负责保留换行和缩进,code 负责声明“这是代码”——语义和格式缺一不可。单独用任一标签,都会让 SEO、语法高亮库(如 Prism.js)或屏幕阅读器失效。
- ✅ 正确:
function greet(name) { return `Hello, ${name}!`; } - ❌ 错误:
function greet(name) { return `Hello, ${name}!`; }(无格式保留) - ❌ 错误:
function greet(name) { return `Hello, ${name}!`; }(无语义,高亮库无法识别语言) -
pre默认可能横向撑破容器,务必加overflow-x: auto -
code在pre内要设display: block,否则不响应滚动和宽高控制
HTML 特殊字符必须手动转义
只要内容里出现 、<code>>、&,不管是不是代码逻辑需要,都得提前转义。漏掉一个,轻则代码显示不全,重则后续 HTML 解析中断、DOM 损毁。
- 写
x → 必须写成 <code>x - 写
<div class="app"></div>→ 必须写成<div class="app"></div> - 写
price & tax→ 必须写成price & tax - 转义顺序不能错:先转
&,再转和 <code>>,否则可能被二次解析
最容易被忽略的是职责混淆:有人把整段 Shell 脚本塞进 code,有人给 console.log() 单独包一层 pre。判断标准只有一个——要不要保留原始换行和缩进。其余都是副作用。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











