404页面必须由服务器返回http状态码404,html仅作响应体;title和h1须含“404”文字以利seo与无障碍;样式须内联、字体用系统栈、图片用内联svg或data uri;禁用js依赖与外部资源。

HTML 本身不能“设置”404状态码,它只是响应体内容;真正起作用的是服务器返回的 Status: 404 Not Found 响应头。你写的 HTML 布局只有在服务端正确配置、真实返回 404 状态时才被识别为 404 页面——否则就是个普通 200 页面,再漂亮也白搭。
确保 <title></title> 和 <h1></h1> 明确含 “404” 字样
搜索引擎和屏幕阅读器不靠视觉判断错误,而依赖语义标签中的文字。若 <title></title> 是 “首页” 或空着,爬虫会当正常页收录;若 <h1></h1> 写 “哎呀迷路啦”,辅助技术无法识别上下文。
-
<title></title>必须直写<title>404 - 页面未找到</title>,不能靠 JS 动态插入 -
<h1></h1>必须是纯文本<h1>页面未找到(404)</h1>,避免用 SVG/Canvas 渲染数字,除非加aria-label="404" - 主内容区必须包裹在
<main></main>或带role="main"的容器里,让辅助工具跳过导航直读错误 - 加
<meta name="robots" content="noindex">,防止被误抓取
用纯 HTML + 内联 <style></style> 实现响应式居中与可读性
404 页面常出现在资源加载失败场景(比如 /assets/main.css 本身 404),外链 CSS 失败 = 白屏。移动端弱网下更敏感,所有样式必须内联且精简。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML,替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度,HTML 能同时承载排版、表格、SVG 等。
- 垂直水平居中用
display: flex; height: 100vh;,比position: absolute更稳、无依赖 -
<h1></h1>字号建议clamp(2.5rem, 5vw, 4rem),小屏自动缩放,避免固定px在 iPhone 上溢出 - 文字与背景对比度 ≥ 4.5:1,例如
#333配#fff可行,配#eee不行——用 webaim.org/contrastchecker 实测 - 禁用
@import、删空格注释,整段<style></style>控制在 1KB 以内
所有跳转链接必须是纯 @#@#@#@#@#@#@#@#@#@1,不是 <button onclick="location.href='/'"></button>
document.referrer 同域且非空才渲染,否则跳过或置灰,href 设为 #
<form action="/search" method="GET"><input name="q"></form>,不绑定 submit 事件——提交失败时用户至少能看到 URL 变化<meta http-equiv="refresh"> 和 setTimeout(() => location.href = '/', 2000),这会让状态码变成 200图片和图标必须用内联 SVG 或 Data URI
404 页面路径本身就是异常的,再请求 /img/404-icon.png 很可能触发第二次 404,拖慢渲染甚至留白。
- 用内联 SVG:直接把 SVG XML 写进 HTML,如
<svg viewbox="0 0 100 100">...</svg>,无需额外请求 - 小图标可用 Data URI:
<img src="data:image/svg+xml;base64,PHN2ZyB2..."> - 绝对不用相对路径图片:
./icon.svg在/a/b/c下会请求/a/b/icon.svg,大概率 404 - 字体必须用系统栈:
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;,禁 Web Font
最容易被忽略的点:你改好了 HTML,但没验证服务器是否真返回了 Status: 404 Not Found。本地双击打开 404.html 永远是 file:// 协议,没有状态码概念。必须用 npx serve 或 curl -I https://yoursite.com/nonexistent 看第一行输出,否则一切布局优化都是空中楼阁。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










