标签仅作等宽字体样式呈现，不解析路径语义，复制时易带空格或换行；长路径需配合 或 white-space: nowrap；路径中 & 需转义，~ 等符号须说明含义； 和 不适用于路径。

code 标签不能自动识别路径语义，只负责视觉呈现

<code> 是纯样式标签，浏览器不会把它当路径解析，也不会加斜体、下划线或可点击行为。它只是告诉浏览器：“这段文字要按等宽字体显示，且保持空格和换行”。所以写 /etc/nginx/nginx.conf，用户看到的是等宽字体的路径，但复制粘贴时可能多出空格、换行，或在某些 CSS 下被截断。

路径里有斜杠、点、下划线时要小心转义和空格

HTML 本身不强制要求对路径字符转义，但以下情况容易出问题：

• /etc/nginx/sites-enabled/default 中的斜杠没问题，但若路径含 &（如 config&backup.conf），必须写成 config&backup.conf，否则 HTML 解析失败
• 路径末尾带空格（比如误粘贴了）会变成不可见错误：写成 /var/log/nginx/ （末尾有空格），<code> 会照常渲染，但用户复制后执行命令会报 No such file or directory
• 长路径在小屏幕易折行，建议外层套 <pre class="brush:php;toolbar:false;"></pre> 或加 CSS white-space: nowrap

嵌入配置文件内容时，别用 code 套整个文件

如果想展示一段配置，比如 Nginx 的 server 块，直接用 <code> 包裹多行文本会导致换行丢失（HTML 默认合并空白）。正确做法是：

Wechat HTML Publisher

直接上传HTML富文本到微信公众号草稿箱。支持完整的HTML格式,无需Markdown转换。

下载

• 用 <pre class="brush:php;toolbar:false;">&lt;code&gt;...&lt;/code&gt;</pre>
• 确保原始文本里的缩进用空格（不是 Tab），否则部分浏览器可能压缩掉
• 避免在 <code> 内写 HTML 实体以外的 或 <code>>，比如 location / { 没问题，但 if ($request_method != 'GET') { 里的 != 不需要转义；而 <script></script> 这种必须写成 <script>

和 kbd、var 混用时语义容易错乱

有人会把路径写成 <kbd>/home/user/.bashrc</kbd>，这是错的——<kbd></kbd> 表示“用户应按键输入的内容”，适合 <kbd>Ctrl+C</kbd>；路径是“系统中客观存在的位置”，该用 <code>。同理，<var></var> 表示变量名（如 <var>$PORT</var>），不是路径。

真正容易被忽略的是：路径是否带用户上下文。比如 ~/.gitconfig 里的 ~ 不是字面路径，得说明“表示当前用户主目录”；否则读者在脚本里直接复制过去会失败。

前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！