使用<code>和<pre>标签结合CSS样式是HTML中正确显示代码的核心方法，<code>提供语义化，<pre>保留格式，通过设置等宽字体、背景色、内边距、圆角及水平滚动等样式可提升可读性与美观度，同时需将特殊字符转义为HTML实体以避免解析错误，结合语法高亮库如Prism.js可进一步增强专业性。
要在HTML中正确、美观地显示代码，最核心的方法是利用
<code>标签来语义化代码片段，并经常与
<pre>标签结合使用，以保留代码的格式（如空格和换行）。通过简单的CSS样式，就能让这些代码块在视觉上清晰易读。
解决方案
当我们需要在网页上展示代码时，直接粘贴往往会遇到各种问题，比如HTML会将
<和
>误认为是标签，导致代码显示不全，或者大量的空格和换行被浏览器自动折叠。解决这些问题的关键在于使用正确的HTML标签和一些辅助的CSS样式。
首先，
<code>标签是用来表示计算机代码的。它的语义作用是告诉浏览器和搜索引擎，这部分内容是一段代码。单独使用
<code>标签时，它是一个行内元素，适合于在段落中嵌入简短的代码片段，比如
p标签里的
<span>。
<p>在JavaScript中，我们经常使用`console.log()`来调试。</p>
然而，仅仅使用
<code>标签并不能解决代码格式被浏览器“优化”的问题（即多个空格被缩减为一个，换行符被忽略）。这时，就需要引入
<pre>标签了。
<pre>标签（preformatted text）会保留其中文本的原始格式，包括空格和换行。所以，当我们需要显示一段完整的、多行的代码块时，最佳实践是将
<code>标签嵌套在
<pre>标签内部。
立即学习“前端免费学习笔记（深入）”；
<pre><code>
function greet(name) {
console.log(`Hello, ${name}!`);
}
greet('World');
</code></pre>这样做的好处是：
<pre>确保了代码的格式不变，而
<code>则赋予了这部分内容“代码”的语义。
为了让代码块看起来更专业、更易读，我们还需要一些CSS样式。通常，我们会给
<pre><code>组合添加以下样式：
pre {
background-color: #f4f4f4; /* 浅灰色背景，让代码块更突出 */
padding: 15px; /* 内边距，避免代码贴边 */
border-radius: 5px; /* 圆角边框，视觉更柔和 */
overflow-x: auto; /* 当代码行过长时，允许水平滚动 */
font-family: 'Consolas', 'Monaco', monospace; /* 等宽字体，提高代码可读性 */
font-size: 0.9em; /* 稍微小一点的字体 */
line-height: 1.6; /* 行高，避免行距过密 */
}
/* 针对行内代码的样式 */
code {
background-color: #eee; /* 稍微深一点的背景色，与普通文本区分 */
padding: 2px 4px; /* 小内边距 */
border-radius: 3px; /* 小圆角 */
font-family: 'Consolas', 'Monaco', monospace;
font-size: 0.9em;
}通过这些设置，你的代码在网页上就能既有正确的语义，又能有良好的视觉呈现了。我个人觉得，一个好的代码显示效果，是技术文章质量的重要组成部分。
为什么直接粘贴代码到HTML中会出问题？
这其实是个很基础但又常被忽视的问题。当你直接把一段代码，比如
<div>Hello</div>，复制粘贴到HTML文件的普通文本区域，而不是用
<code>或
<pre>包裹时，浏览器会把它当作普通的HTML内容来解析。这会导致几个主要问题：
首先是特殊字符的解析。HTML有它自己的一套规则，像
<、
>、
&这些字符，在HTML中都有特殊的含义。
<表示标签的开始，
>表示标签的结束，
&则用于表示HTML实体（如
&表示
&）。所以，如果你直接写
<div>，浏览器会认为你是在定义一个
div标签，而不是显示“
<div>”这个字符串。它会尝试渲染这个
div，而不是把它作为文本展示出来。解决这个问题的办法是使用HTML实体，比如
<表示
<，
>表示
>，
&表示
&。
其次是空白字符的折叠。HTML在渲染时，会将连续的多个空格、制表符和换行符折叠成一个单一的空格。这意味着你的代码中精心排布的缩进和空行都会丢失，导致代码变得难以阅读。这是HTML的默认行为，旨在优化文本内容的显示，但对于代码来说，这恰恰是灾难性的。
最后，缺乏语义。即使通过实体编码解决了特殊字符的问题，直接放在
p标签或者
div标签里的代码，对于搜索引擎和辅助阅读设备来说，也仅仅是普通的文本。它们无法识别这部分内容是“代码”，这会影响内容的语义化和可访问性。
所以，
<code>和
<pre>标签的存在，就是为了解决这些根本性的问题。它们告诉浏览器：“嘿，这块内容不是普通的HTML，它是一段需要特殊处理的代码！”
如何让代码块看起来更专业、更易读？
让代码块看起来专业且易读，不仅仅是把代码放进去就完事了，视觉上的优化同样关键。除了前面提到的基础CSS，这里还有一些我常用的技巧和思考：
-
选择合适的等宽字体：这是最基础也是最重要的。代码需要等宽字体，这样字符宽度一致，对齐才不会乱。
font-family: 'Consolas', 'Monaco', 'Courier New', monospace;
是一个不错的选择链，确保在不同系统下都能找到合适的等宽字体。 -
背景色与边框：给代码块一个浅色的背景（比如
#f4f4f4
或#2d2d2d
，取决于你的主题是亮色还是暗色），并加上一点点圆角和内边距，能让代码块从周围的文本中“跳”出来，形成视觉上的区隔。我通常会避免使用过于鲜艳的背景色，以免分散读者的注意力。 -
溢出处理：
overflow-x: auto;
这个属性简直是神器。它能确保当代码行过长时，不会撑破布局，而是出现一个水平滚动条，用户可以滑动查看。这对于响应式设计尤其重要，手机屏幕宽度有限，代码行很容易溢出。 -
行高与字号：适当的
line-height
（比如1.5到1.8之间）可以增加代码行之间的间距，避免代码挤在一起。font-size
通常会比正文略小一点，但也要保证清晰可读。 - 语法高亮：这绝对是提升专业度的杀手锏。虽然HTML和CSS本身无法实现，但引入像Prism.js或Highlight.js这样的JavaScript库，可以自动识别代码语言并给不同类型的代码元素（关键字、字符串、注释等）上色。这大大提高了代码的可读性和美观度。我个人非常推荐使用这些库，它们能让你的代码块看起来就像IDE里一样专业。不过，引入这些库会增加页面加载负担，所以要权衡利弊。
- 行号显示（可选）：有些语法高亮库也支持显示行号。这对于需要引用特定代码行的技术文章很有帮助。但对于短小的代码片段，行号可能反而显得多余。
在我看来，一个好的代码显示效果，应该是在不分散读者注意力的前提下，尽可能地提高代码的可读性。
除了<code>
和<pre>
，还有哪些代码显示的最佳实践？
除了最基本的
<code>和
<pre>组合，为了提供更优质的用户体验和更强的语义化，我们还可以考虑以下一些最佳实践：
-
更细致的语义化标签：HTML5提供了一些更具体的语义化标签，虽然它们不直接改变代码的显示方式，但能进一步明确内容的含义：
<kbd>
：表示用户输入（键盘输入）。比如“按`Ctrl + C复制”。<samp>
：表示程序输出或示例输出。比如“控制台显示：<samp>Error: File not found</samp>
”。<var>
：表示变量。比如“定义变量<var>x</var>
”。 虽然这些标签不常用，但在特定场景下，它们能让你的内容语义更精确。
-
可访问性（Accessibility）：确保代码块对所有用户都是可访问的。
- 颜色对比度：如果你使用了语法高亮，确保不同颜色之间的对比度足够高，以便色盲用户也能区分。
-
文本可缩放性：不要使用固定的像素单位来设置字体大小，而是使用
em
、rem
或%
，这样用户可以根据自己的需求调整浏览器字体大小。 -
语义化结构：
<code>
和<pre>
本身就提供了很好的语义，这有助于屏幕阅读器理解内容。
响应式设计：前面提到了
overflow-x: auto;
，这是响应式代码块的关键。确保在小屏幕设备上，代码块不会溢出或破坏布局。我有时候会发现，即使设置了overflow-x: auto;
，在某些移动端浏览器上表现也不是那么完美，可能还需要一些特定的meta
标签或者更细致的CSS媒体查询来辅助。“复制到剪贴板”功能：对于技术文章来说，用户经常需要复制代码。提供一个“复制”按钮，通过JavaScript实现一键复制功能，能极大地提升用户体验。这虽然超出了HTML/CSS的范畴，但作为最佳实践，值得考虑。
避免手动行号：除非你使用的是专业的语法高亮库，否则不要尝试手动在代码块中添加行号。这不仅维护成本高，而且很容易出错，还可能干扰代码的复制粘贴。让专业的工具去做专业的事情。
注释和解释：在展示代码时，好的实践是不仅展示代码，还要对代码的关键部分进行解释。这可以是代码内部的注释，也可以是代码块前后的文字说明。我发现，很多时候，代码本身并不能完全说明问题，配合清晰的解释，效果会好很多。
这些实践，从语义到交互，再到视觉，都是为了让你的代码展示更加完善和用户友好。
