命令行指令应依语义选用或:单条不换行用,含管道、多行或输出示例则用; &等需转义为< > &;长命令须拆分或加css控制。

直接用
标签包裹命令行指令即可,但必须注意转义、语义和上下文——它不是“代码高亮容器”,而是“行内技术名词标记”。 <h3>命令行指令该用 <code> 还是 <pre class="brush:php;toolbar:false;">
单条不换行的指令(如 npm install
git status)必须用 ;含管道、重定向、多行结构或输出示例的,必须用 <pre class="brush:php;toolbar:false;"><code> 组合。 <ul><li><code>curl -X POST http://localhost:3000/api</code></li></ul></code>✅ 正确:单行、无特殊字符、嵌在段落中自然
ls -la | grep ".js" ❌ 危险:| 虽安全,但语义上已是“复合操作”,建议用 <pre class="brush:php;toolbar:false;"> 更清晰
<code>$ git log --oneline a1b2c3d fix: handle null input e4f5g6h feat: add retry logic</code>✅ 正确:保留提示符 $、缩进、换行,且声明了语义
命令里出现 、<code>>、& 必须转义
哪怕只是写个重定向或比较,漏转义就会让 HTML 解析中断,后续内容错位甚至消失。
- 错误写法:
echo "hello" > output.txt→ 浏览器把>当成标签闭合,实际渲染可能只剩echo "hello" - 正确写法:
echo "hello" > output.txt - 同理:
if [ $x -lt 5 ] && [ $y -gt 10 ]中的-lt和-gt是 Bash 比较操作符,不用转义;但和 <code>>符号本身必须转为和 <code>>
标签不能自动处理换行或长命令折行
它默认是行内元素,不会换行,也不会限制宽度——长命令会撑破容器,或在单词中间硬折(如 npm run build:staging:with-sourcemap)。
- 别指望
white-space: pre-wrap或word-break: break-all来“修”它:前者破坏行内基线对齐,后者折断命令语义 - 真有超长命令,优先拆成多行 +
<code>,或改用短名/别名说明(如“等价于 <code>npm run build:prod</code>”)</code>
- 若坚持单行展示,至少加 CSS 控制:
code { font-family: monospace; overflow-x: auto; display: inline-block; max-width: 100%; },但注意这会让它脱离文本流
最容易被忽略的是:命令行指令不是“可运行代码”,而是“用户要输入的文本”。所以 的核心任务从来不是高亮,而是准确传达“这是一个要敲进去的字符串”,转义和语义比颜色更重要。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











