第一次手写页面的人大多碰到过这个现象:把设计稿里的几段文字直接粘进 body,保存、刷新,结果所有字挤成一大坨,只在窗口边缘才折行。明明在编辑器里按了回车,浏览器却像没看见。原因不神秘:HTML 源码里的换行和连续空格会被折叠成一个空格,浏览器只认标签表达的结构,不认你在文件里怎么排版。
这篇讲什么:从一份文档最少需要哪几个部分讲起,把 head 和 body 的职责分开,再讲最常用的标题、段落、列表、块级与行内元素和属性。读完你能不看模板写出结构完整、嵌套正确的页面,也能指出别人给的 HTML 哪一层放错了。
先看整体:一份文档由哪几层组成
把一份 HTML 文件想象成寄快递:外层是包装声明,里面是整份文档,文档再分成说明单据和真正要送的东西两层。对应到代码就是下面这个形状。
<!DOCTYPE html>:告诉浏览器按现代标准解析<html lang="zh-CN">:整份文档的根,包住下面所有内容<head>:编码、标题、样式表等给浏览器看的信息<body>:用户在页面上真正看到的内容很多人写页面时只关心 body,head 里那几行是复制来的,从来不改。小项目里这么干通常不会立刻出问题,但一旦出现中文乱码、手机端字号过小、搜索结果里标题难看,排查方向基本都在 head。这两块都很短,值得一次搞明白。
那行 <!DOCTYPE html> 最容易被当成可删的废话。删掉之后页面不会立刻报错,浏览器会退回到「怪异模式」:盒模型宽度、行高、百分比高度的算法都和标准模式不一样,你照着现代教程写的 CSS 可能对不上号。老项目里那些「明明设了宽度还是溢出」的怪问题,有一部分就是这行没了。lang="zh-CN" 影响读屏语音和翻译提示,写错页面照样显示,中文页面写 zh-CN 就行。
head:不显示,但决定了页面怎么被读
head 里的内容不会画在页面上,更像给浏览器和外部程序的说明书:编码、视口、标题、样式表、脚本,以及给搜索引擎和社交平台看的描述。这里先说三个最容易出问题的。
charset:中文乱码的根源
<meta charset="utf-8"> 告诉浏览器用 UTF-8 来读这份文件。文件本身也得真的以 UTF-8 保存,两边对不上就会看到「锟斤拷」那种乱码。这件事以前很常见,现在编辑器基本默认 UTF-8,反而容易忽略另一面:这行必须尽量靠前,放在 head 的最前面。浏览器先读字节、后解析标签,读到一半才看到声明,前面的内容可能已经按错误编码解出。规范要求它出现在前 1024 个字节内,放第一行最省事。
反过来也成立:文件存成 UTF-8,声明却写成 gbk,中文同样会乱。排查时先看编辑器右下角显示的编码,再对照这行声明,两边必须一致,只改一边解决不了。
title:标签页和搜索结果的标题
<title> 是页面的标题,但它不只出现在浏览器标签上:收藏夹、搜索结果的第一行、分享到聊天软件时的卡片标题,很多地方都拿它当名字。写法上有个经验:把「这篇讲什么」放前面,站点名放后面,中间用短横线或竖线隔开,比如「文档结构与常用标签 · 科设文档」。别所有页面都叫「首页」,也别堆一长串关键词,用户在标签页里只能看到十来个字,后面的都被截掉。
顺带一个取舍:单页应用靠前端路由切换内容时,要同步改 title,否则开五个标签页全是同一个名字,找起来很痛苦。这个站是静态多页面,不存在这个问题。
viewport:手机端字小的直接原因
这一行比前两个更容易被漏:<meta name="viewport" content="width=device-width, initial-scale=1">。没写它的时候,手机浏览器会假设你这份页面是给桌面显示器写的,先开一个大约 980 像素宽的虚拟窗口来排版,再把结果整体缩小塞进屏幕。你在手机上看到的「字小得要双指放大」,大多是这个机制造成的。补上之后,页面的布局宽度等于设备宽度,字号按 CSS 写的来。
但它不是加一行就万事大吉。原来按固定宽度设计的布局,加上这一行会直接挤爆:横向滚动、文字换行、卡片溢出都会冒出来。这一行的真实含义是「我要按响应式做页面」,代价是后面得配合流式宽度和断点。如果页面确实是固定宽度的工具页,先别加。
body 里的常用标签
body 是内容区。日常页面里出现频率最高的,其实就三类:标题、段落、列表。剩下的表格、图片、表单,后面几篇单独讲。
标题与段落
标题用 h1 到 h6,数字表示层级,不是字号。一个页面通常只有一个 h1;下面依次用 h2、h3。别因为「h3 字太小」跳去用 h2,字号归 CSS,层级归结构。跳级会让读屏用户失去大纲判断,也让搜索引擎难以理解主次。
段落用 p。一段话一个 p,这是最省心的做法。有人图快,用 br 来制造段间距,结果每段变成了同一段落里的换行,读屏软件会一口气读下去,复制出去也粘成一段。真要分段,就老老实实开新的 p。
<h1>前端基础:从输入网址到页面出现</h1>
<p>这篇文章讲浏览器在背后做了哪些事。</p>
<h2>一、地址栏之后发生了什么</h2>
<p>先解析域名,再建立连接,然后请求文件。</p>
<h2>二、页面是怎么画出来的</h2>
<p>浏览器会先把 HTML 解析成 DOM 树。</p>
这里有个容易踩的坑:p 里不能放块级元素。你写 <p>前言<div>正文</div></p>,浏览器不会报错,它会自作主张把 p 提前闭合,再把 div 挪到外面。你在编辑器里看着嵌套是对的,打开开发者工具却发现结构变了。凡是「明明写了却没生效」,先看 Elements 面板里浏览器实际解析出来的结构,而不是只看源码。
顺带一句:想在页面上显示尖括号,要写 <,直接写会被当成标签开头,后面的内容可能被吞掉。代码示例里的转义字符不是装饰。
列表:有序、无序、描述
列表有三种,别混着用:
| 标签 | 用途 | 典型场景 |
|---|---|---|
ul + li | 无序列表,顺序不重要 | 导航菜单、标签列表、功能点罗列 |
ol + li | 有序列表,顺序有意义 | 操作步骤、排名、教程章节 |
dl + dt + dd | 名称与解释成对出现 | 术语表、参数说明、常见问题 |
实际项目里最常见的误用,是把导航写成 ul 但不套 nav,或者把「第一步、第二步」写成 ul。前者影响可访问性,后者只是语义不够准,问题不大。
列表还有一笔样式账。默认的圆点和缩进来自浏览器,设计稿经常要求去掉。只写 list-style: none,圆点会消失但左内边距还在,文字仍然缩进;顺手把 padding 也清零,文字又会贴到容器边。两种情况都要单独确认。先记住「结构归 HTML,样子归 CSS」,后面讲盒模型时再收。
块级与行内:为什么有的标签会换行
同样放在 body 里,div 独占一行,span 却和前后文字排在同一行。原因是默认 display 不同:块级默认 block,行内默认 inline。这个默认值可以被 CSS 改掉,所以「块级标签」「行内标签」更准确的说法是「默认块级显示的元素」「默认行内显示的元素」。
| 对比项 | 块级(如 div、p、h2) | 行内(如 span、a、strong) |
|---|---|---|
| 换行 | 前后自动换行,独占一行 | 不换行,和文字排在一起 |
| 宽高 | 可以设置 width、height | 设置宽高不生效,由内容撑开 |
| 内外边距 | 四个方向的 margin、padding 都生效 | 左右生效,上下的表现要看行盒,常被认为不生效 |
| 典型用途 | 页面分区、卡片、段落 | 一句话里的局部强调、链接、图标 |
这里有个真实取舍。很多团队所有容器都用 div,因为「没有默认样式,好控制」,代价是满屏无名容器,接手的人看不出哪块是导航、哪块是正文。另一派坚持语义标签,代价是要多记标签、处理默认边距。我的做法是:页面大分区用语义标签,纯装饰包裹层用 div,一句话里的局部用 span。
span 里放 div。浏览器通常会容忍,但解析结果可能和你写的不一样,布局也会变得难以预测。判断标准是:这个元素的默认显示方式能不能包住另一个块。属性:给元素补充信息
属性写在开始标签里,形式是「名字=值」。有些属性所有元素都能用,叫全局属性;有些只能用在特定元素上,比如 href 只能用在链接上。日常最常用的几个:
id:页面内唯一的名字。用来做锚点跳转、label关联表单控件、或者被脚本查找。一个页面里不能有两个相同的id,重复了浏览器不报错,但跳转和脚本取值会不可预测。class:可以重复的样式类名,一个元素可以写多个,用空格隔开。它是给 CSS 和脚本用的「标签」,不具备唯一性。style:直接写行内样式。调试时方便,长期维护是负担,因为它优先级高,后面想用样式表覆盖会很别扭。除非是脚本动态计算出来的值,否则尽量别用。title:鼠标悬停时显示的补充说明。移动端没有悬停,重要信息别只放在这里。data-*:自定义数据属性,比如data-id="42"。把一小段数据挂在元素上,脚本读取方便,也不会和标准属性冲突。
用 id 还是 class 的判断很简单:要被锚点跳转、被 label 关联、被脚本唯一定位,才用 id;其余一律 class。给每个元素都写 id 的人,复制粘贴时容易留下两个同名 id,锚点跳转开始飘。
还有一类叫布尔属性,比如 disabled、checked、required。它们不需要写值,写出来就代表开启,去掉就代表关闭。你写 disabled="false" 不会关掉禁用,反而仍然是禁用,因为「有这个属性」就算数。这个坑在表单里特别常见,后面讲表单时会再遇到。
场景走查:一页课程介绍,从半小时到两天
有一年帮朋友做线下培训的课程介绍页:主标题、课程简介、四个模块说明、报名流程。文案一段段从聊天软件发来,段间用空行隔开。我判断「这种单页半小时能做完」,直接开写。
第一版用了最省事的写法:head 里只留了从别的项目复制来的 charset 和 title,视口那一行顺手删了,理由是「就一页,无所谓」;body 里用 div 分包,文案整段粘进去,段落之间用 br 隔开;四个模块的标题用 div 加粗放大字号;报名流程写成一句话,用逗号把步骤连起来。桌面浏览器里看着还算整齐,我就交付了。
第二天朋友转来两条反馈:手机字小,以及「介绍和模块挤成一块,看不出哪里另起一段」。我用手机打开,字确实小;全篇只有 br,屏幕一窄,换行全乱。更隐蔽的问题在第三个模块:我想给说明加浅底色,在 p 里套了一个 div。编辑器里缩进正常,开发者工具一查,p 在我写 div 的位置就被提前闭合,说明块跑到段落外面,底色只包住半句话。
这次修改我没有先动 CSS,而是把结构重写了一遍。视口那行补回去;每个自然段拆成独立的 p,删掉所有 br;主标题换成 h1,四个模块用 h2,模块内的小点用 h3;报名流程改成 ol,因为步骤顺序不能乱;那个想嵌套的说明块,改成 p 之后紧跟一个独立的 div。刷新之后,手机上的字号恢复正常,段落有了间距,读屏软件也能按标题一段段跳着念。
这件事花的时间远不止半小时:真正耗时的是把用 br 和 div 拼出来的假结构拆掉。结构错了,CSS 只能一层层打补丁;结构对了,大部分样式问题根本不会出现。
错误现象对照
下表这些现象,前三个我在真实项目里都遇到过不止一次。排查顺序建议是:先在 Elements 面板看浏览器解析后的真实结构,再看 head 里的编码、视口、标题,然后看计算样式,最后做最小复现。先确认浏览器实际解析成了什么,再怀疑自己的写法。
| 现象 | 真实原因 | 第一步查什么 |
|---|---|---|
| 几段文字挤成一整块,只在窗口边缘折行 | 源码里的换行被折叠,没有用 p 分段 | 看 Elements 面板,确认文字是不是全在同一个节点里 |
| 手机上字小得必须双指放大 | 缺少视口声明,浏览器按约 980 像素的虚拟宽度渲染后整体缩放 | 查 head 里有没有 viewport 那一行 |
| 中文显示成方块或乱码 | 编码声明缺失、写错,或文件保存编码与声明不一致 | 对照编辑器当前编码与 meta charset |
| 标签明明写了,打开却变成别的嵌套 | 非法嵌套被浏览器自动纠正,例如 p 里放块级元素 | 看 Elements 面板里实际生成的树,而不是源码 |
| 页面顶部凭空多出一段空白 | 标题或段落的默认外边距没有处理,body 的默认边距也还在 | 看计算样式里的 margin |
| 列表圆点没了,文字位置也不对 | 只改了 list-style,没确认左内边距是保留还是清零 | 查 ul 的计算 padding-left |
边界与代价
第一类是框架生成页面的项目。React、Vue 里你写的是组件,最终 HTML 由框架拼出来;某个卡片组件内部可能已经是 div,你把它塞进 p 里,浏览器照样会拆。这要靠组件约定兜底,不能指望「手写时注意」。
第二类是邮件 HTML。邮件客户端对标签和样式的支持保守得多,head 里很多东西会被过滤,现代布局常常不生效。做邮件模板时,常见做法是退回表格布局加内联样式,本篇的结构只能参考一部分。
第三类是用户生成的富文本。后台编辑器输出的 HTML 你控制不了,可能有嵌套错误,也可能混进危险标签,需要服务端做白名单过滤,而不是假设它结构正确。
规模上也有临界点。几个页面手写还行,几十上百个页面时,head 那几行靠人记迟早不一致。到那个规模,应该抽模板或组件,把 charset、viewport、title 统一收口。
还有几个副作用:加了视口声明,固定宽度布局会崩,必须同时改布局;把 div 换成有默认边距的标签,页面间距会变,要补重置样式;p 不能包含块级元素,「段落里嵌卡片」在 HTML 层面就不成立,只能拆成并列节点再用 CSS 摆。这些不是写错了,是写法本身的代价。
小结与练习
这篇的核心其实就三句话:HTML 用标签表达结构,不负责样子;head 管「怎么被读」,body 管「显示什么」;嵌套错了浏览器会悄悄帮你修,修完的结构往往不是你想要的。下次遇到显示怪现象,先去 Elements 面板看浏览器解析后的真实结构,这一步能省掉很多瞎猜。
当天可以自己验证的几件事:
- 把自己页面的视口声明删掉,用设备模拟打开,对比字号,再加回去。
- 故意写一个
<p>前言<div>正文</div></p>,在 Elements 面板里看浏览器怎么拆,记住这个行为。 - 打开任意一篇常看的网页,数标题层级:有几个
h1,有没有从h2跳到h4。 - 用
br分段和用p分段各写一段,然后复制到聊天窗口里,比较粘贴结果的差别。 - 把
disabled="false"写在一个按钮上,确认它仍是禁用状态,理解布尔属性的判断方式。
结构会写了,下一步要解决的是「用什么标签表达什么含义」。同样是分区块,div 能用,但 header、nav、main 这些标签能让读屏软件和搜索引擎更准确地理解页面。下一篇 语义化标签 讲的不是背标签,而是判断「这块内容到底算什么」,以及什么时候用 div 反而更合适。