HTML网页制作须遵守四条硬性规范:一是DOCTYPE声明必须唯一且置于文件开头,禁用BOM和XHTML写法;二是嵌套须符合内容模型,如ul/ol仅含li、p不可包h1等;三是class/id命名强制小写加短横线(kebab-case)且id全局唯一;四是资源路径须用相对路径并借助Live Server调试,避免file://协议限制。

HTML网页制作没有“万能模板”,但有几条硬性规范必须遵守,否则轻则样式错乱、脚本失效,重则SEO归零、无障碍访问被拒。
DOCTYPE 声明必须写且只能写一次
不写 !DOCTYPE html,浏览器会进入怪异模式(Quirks Mode),box-sizing、vertical-align 等行为全变样,连居中都可能失灵。
- 必须放在文件最开头,前面不能有任何字符(包括空格、BOM头);VS Code 保存时勾选“UTF-8 with BOM”就会悄悄埋雷
- 大小写敏感:
!doctype html或都合法,但建议统一用小写 <code>!doctype html - 别手滑复制成
..>—— 这是 XHTML 遗留写法,HTML5 不需要 DTD 引用
嵌套必须符合内容模型,不是闭合了就行
浏览器容错强,但容错不等于正确。<div>
<p></p>
<ul></ul>
</div>
<p></p> 会被自动截断,<ul></ul> 被踢到 <div> 外面——结构彻底崩坏。<p><span>立即学习</span>“<a href="https://pan.quark.cn/s/cb6835dc7db1" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">前端免费学习笔记(深入)</a>”;</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill13305" title="AgentGen — HTML to PDF & Image"><img
src="https://img.php.cn/upload/skill/001/246/273/6adaf20cf0281539.jpg" alt="AgentGen — HTML to PDF & Image" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill13305" title="AgentGen — HTML to PDF & Image">AgentGen — HTML to PDF & Image</a>
<p>将 HTML 转换为 PDF 和图片。无需注册,免费版开箱即用(每分钟 1 次请求,含水印)。如需更高频次及去水印……</p>
</div>
<a href="/xiazai/skill13305" title="AgentGen — HTML to PDF & Image" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div>
<ul><li>
<code><ul></ul> 和 <ol></ol> 只能直接包含 <li>,不能塞 <p></p>、<div> 或另一个列表
<li>
<code><p></p> 是段落容器,不能包 <h1></h1>、<div>、<code><ul></ul> —— 这些属于“流内容”,但不是“段落级内容”
class/id 命名必须小写+短横线,且全局唯一
CSS 和 JS 对大小写零容忍:class="HeaderNav" 和 class="headernav" 是两个类;id="Main" 和 document.getElementById("main") 查不到。
- 强制用 kebab-case:
main-header、user-avatar、btn-primary,禁用btnPrimary或btn_primary -
id必须唯一,哪怕只用一次也要当心:Vue/React 组件复用时,id="modal"出现在多个实例里,label[for="modal"]就会绑定错目标 - 别用数字开头:
class="1col"是非法类名,CSS 里无法匹配;class="col-1"才安全
路径和资源加载必须用相对路径 + Live Server 调试
直接双击打开 index.html 会触发 file:// 协议限制:fetch 失败、@import 失效、图片显示为空白方块,控制台却常无报错。
- 路径一律从当前 HTML 文件出发算:
src="img/logo.png"(同级)、src="../css/style.css"(上一级)、src="./data.json"(当前目录) - 绝对路径写成
/img/logo.png是以站点根目录为基准,本地调试时需起服务,否则 404 - VS Code 装
Live Server插件,右键 → “Open with Live Server”,地址变成http://127.0.0.1:5500/,所有资源加载才真实可靠
真正卡住新手的,从来不是标签怎么写,而是浏览器没按你“以为”的方式解析 DOM。多看 Elements 面板,少信“我明明闭合了”。


















